本页介绍了如何使用签名网址在 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)。