本页面介绍了如何在 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中。
如需详细了解已获授权的视图的精细权限,请参阅精细访问权限控制概览。
开始之前,请执行以下步骤:
- 确保您已将语音对话导入 CX Insights,并且这些对话具有指向 Cloud Storage 存储桶中音频文件的音频 URI。这可以通过以下方式实现:
- 前往项目设置页面,找到您的 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)。