此 Genesys Cloud 音频连接器可高效捕获、处理和分析联络中心互动中的实时音频流。它使用与 Audiohook 服务的持久 WebSocket 连接,与 Genesys Cloud Audiohook API 无缝集成。此连接支持通过 gRPC 将实时音频流式传输到 Agent Assist 集成后端。该连接器提供了一个用于处理传入音频块的框架,支持自定义音频处理、转写或其他 AI 驱动的功能,例如摘要、主动生成式知识辅助。
前提条件
在开始 Genesys Cloud 语音集成之前,请按照以下步骤操作:
有关如何为 Genesys Cloud 创建和使用 OAuth 客户端的文档提供了有关指定授权类型、重定向、令牌时长以及智能体使用的 AI 赋能功能的说明。
- 安装 Agent Assist 集成后端。
- 请注意以下变量:
- VPC_CONNECTOR_NAME
- SERVICE_REGION
- REDIS_INSTANCE_ID
- 在 Genesys Cloud 中安装 AudioHook 监控器。
使用 Google Cloud CLI 部署 Genesys Cloud 音频连接器服务器
按照以下步骤使用 Google Cloud CLI 部署音频连接器服务器。
- 使用以下代码将 GitHub 代码库克隆到本地机器或开发环境:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations cd genesyscloud/genesyscloud-audiohook
- 前往音频连接器根目录。
在根目录中创建一个 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}
运行位于
./genesyscloud/genesyscloud-audiohook
目录中的 deploy.sh 脚本:sh deploy.sh
配置 Genesys Cloud AudioHook 监控集成
请按照以下步骤配置集成。
- 将语音连接器部署到 Cloud Run 后,在 Genesys Cloud 中配置并激活 AudioHook 监控工具。
- 在 Audiohook Monitor Configuration(监控配置)标签页中,更新以下变量:
- 为渠道选择两者。
- 对于 Audiohook 连接 URI,请使用:
wss://your-cloud-run-domain.run.app/connect
- 在凭据标签页中设置 API 密钥后,更新 ENV 文件中的
API_KEY
环境变量。 - 重新部署语音连接器服务。
- 在队列中启用 AudioHook 监控器。如需了解详情,请参阅 Genesys Cloud 有关创建和配置队列的文章中的“为所有互动类型设置行为和阈值”部分。