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。

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