Genesys Cloud AudioHook 集成

此 Genesys Cloud 音频连接器可高效捕获、处理和分析来自联络中心互动的实时音频流。它使用与 Audiohook 服务的持久 WebSocket 连接与 Genesys Cloud Audiohook API 无缝集成。此连接支持使用 gRPC 向 Agent Assist 集成后端进行实时音频流式传输。该连接器提供了一个用于处理传入音频块的框架，支持自定义音频处理、转录或其他 AI 驱动的功能，例如 摘要、主动生成式知识辅助。

前提条件

在开始 Genesys Cloud 语音集成之前，请按照以下步骤操作：

  1. 安装 Genesys Cloud 应用服务器。
  2. 同时配置 Genesys Cloud OAuth 客户端 和 互动 widget。

有关如何为 Geneysys Cloud 创建和使用 OAuth 客户端 的文档提供了有关指定授权类型、重定向、令牌时长以及座席使用的 AI 赋能功能的说明。

  1. 安装Agent Assist 集成后端。
  2. 记下以下变量：
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. 在 Genesys Cloud 中安装 AudioHook 监控器。

使用 Google Cloud CLI 部署 Genesys Cloud 音频连接器服务器

按照以下步骤使用 Google Cloud CLI 部署音频连接器服务器。

  1. 使用以下代码将 GitHub 代码库 克隆到本地机器或开发环境中： 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. 导航到音频连接器根目录。

  3. 在根目录中创建一个 ENV 文件，并使用以下变量对其进行更新。

    使用与 Agent Assist 集成后端的环境变量相同的值：

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    使用来自不同来源的值：

    • UI_CONNECTOR：已部署的Agent Assist 集成后端服务的域名。
    • GCP_PROJECT_ID：项目的全局唯一标识符。按照以下步骤查找。
    • SERVICE_ACCOUNT：AudioHook 连接器服务的服务帐号。如果不存在，deploy.sh 脚本将创建一个新账号。
    • API_KEY：在 AudioHook 监控器集成中生成 API 密钥。请参阅添加 AudioHook 监控器凭据部分。暂时留空，并在配置 AudioHook 后更新该值。
    • VOICE_INTERCEPTOR_SERVICE：为语音连接器 Cloud Run 服务选择一个名称。

    ENV 文件示例：

    CONVERSATION_PROFILE_NAME=projects/{your-project-id}/locations/{your-service-region}/conversationProfiles/{your-conversation-profile-id}
SERVICE_REGION={your-service-region}
GCP_PROJECT_ID={your-project-id}
API_KEY={api-key-from-genesys}
VPC_CONNECTOR_NAME={vpc-connector-name-from-aa-integration-backend}
SERVICE_ACCOUNT={your-service-account-name}
UI_CONNECTOR={your-agent-assist-backend-domain-name}
REDIS_INSTANCE_ID={redis-instance-id-from-aa-integration-backend}
VOICE_INTERCEPTOR_SERVICE={your-voice-interceptor-service-name}

  4. 运行位于 ./genesyscloud/genesyscloud-audiohook 目录中的 deploy.sh 脚本：

    sh deploy.sh

配置 Genesys Cloud AudioHook 监控器集成

按照以下步骤配置集成。

  1. 将语音连接器部署到 Cloud Run 后，在 Genesys Cloud 中配置并激活 AudioHook 监控器。
  2. 在 Audiohook 监控器配置 标签页中，更新以下变量：
    • 为渠道选择两者 。
    • 对于 Audiohook 连接 URI，请使用： 
      wss://your-cloud-run-domain.run.app/connect
  3. 在凭据 标签页中设置 API 密钥后，更新 ENV 文件中的 API_KEY 环境变量。
  4. 重新部署语音连接器服务。
  5. 在队列内启用 AudioHook 监控器。如需了解详情，请参阅 Genesys Cloud 文章中有关创建和配置队列的“为所有互动类型设置行为和阈值”部分。