启用音频播放

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