Genesys Cloud AudioHook 集成

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

前提条件

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

  1. 安装 Genesys Cloud 应用服务器。
  2. 配置 Genesys Cloud OAuth 客户端和互动微件。
  3. 安装 Agent Assist 集成后端。
  4. 请注意以下变量：
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. 在 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. 运行 ./aa-integration-backend/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. 在 Credentials（凭据）标签页中设置 API 密钥后，请更新 ENV 文件中的 API_KEY 环境变量。
  4. 重新部署语音连接器服务。
  5. 在队列中启用 AudioHook 监视器。如需了解详情，请参阅 Genesys Cloud 关于创建和配置队列的文章中的“为所有互动类型设置行为和阈值”部分。