启用音频播放

本页面介绍了如何在 Customer Experience Insights 控制台中使用签名网址启用音频播放功能。

启用音频播放功能后,您可以直接在 CX Insights 控制台中收听对话音频。音频播放功能使用签名网址,让用户能够以经过身份验证的方式在限定时间内访问存储在 Cloud Storage 存储桶中的音频文件。这样一来,您就无需向用户授予对 Cloud Storage 存储桶的直接访问权限,即可播放音频。

准备工作

如需在 CX Insights 控制台中播放音频,用户需要拥有生成签名音频网址的权限。所需的 IAM 权限取决于您访问对话的方式:

  • 对于所有对话:contactcenterinsights.conversations.generateSignedAudio 权限包含在预定义角色 Contact Center AI Insights viewer 和 Contact Center AI Insights editor 中。
  • 对于通过数据集访问的所有对话:contactcenterinsights.datasets.generateSignedAudio 权限包含在预定义角色 Contact Center AI Insights viewer 和 Contact Center AI Insights editor 中。
  • 对于通过授权视图进行的精细访问(预览版):contactcenterinsights.authorizedConversations.generateSignedAudio 权限包含在预定义角色 Contact Center AI Insights authorizedViewer 和 Contact Center AI Insights authorizedEditor 中。

如需详细了解已获授权的视图的精细权限,请参阅精细访问权限控制概览。

开始之前,请执行以下步骤:

  1. 确保您已将语音对话导入 CX Insights,并且这些对话具有指向 Cloud Storage 存储桶中音频文件的音频 URI。这可以通过以下方式实现:
  2. 前往项目设置页面,找到您的 Google Cloud 项目编号。

启用音频播放

如需使用签名网址启用音频播放功能,您需要向 CX Insights 服务账号授予对 Cloud Storage 存储桶的访问权限,并在该存储桶上配置跨域资源共享 (CORS)。

向服务账号授予对 Cloud Storage 存储桶的访问权限

  • CX Insights 需要访问存储对话音频的 Cloud Storage 存储桶,才能生成签名网址。您需要向 CX Insights 服务账号授予对包含音频文件的存储桶的 Storage Object Viewer 角色 (roles/storage.objectViewer)。

  • CX Insights 服务账号标识符为: service-PROJECT_NUMBER@gcp-sa-contactcenterinsights.

  • 将 PROJECT_NUMBER 替换为您的 Google Cloud 项目编号。

如需了解如何向服务账号授予对存储桶的访问权限,请参阅将主账号添加到存储桶级层政策中。

在 Cloud Storage 存储桶上配置 CORS

如需允许浏览器播放由 CX Insights 生成的签名网址中的音频,您必须在 Cloud Storage 存储桶上配置 CORS,以允许从 CX Insights 控制台来源进行访问。

首先,创建一个名为 cors-config.json 的 JSON 文件,其中包含以下内容:

  [
    {
      "origin": ["https://ccai.cloud.google.com"],
      "responseHeader": ["Content-Type"],
      "method": ["GET"],
      "maxAgeSeconds": 3600
    }
  ]

然后运行以下 gcloud 命令,将 CORS 配置应用于您的存储桶:

  gcloud storage buckets update gs://BUCKET_NAME --cors-file=cors-config.json

最后,将 BUCKET_NAME 替换为包含音频文件的 Cloud Storage 存储桶的名称。如需了解详情,请参阅配置跨域资源共享 (CORS)。