Google Cloud CCaaS

本指南将引导您完成将代理应用连接到 Google Cloud CCaaS 实例的过程。

准备工作

  1. 按照设置和清理页面上的步骤创建或配置您要用于部署的项目。此项目必须与您的代理应用和 Google Cloud CCaaS 实例相关联，并且位于同一 region 中。检查您的项目，确保满足以下条件：
    • Dialogflow API 已启用。
    • 您将用于部署的服务账号具有 Dialogflow API Admin (roles/dialogflow.admin) 权限。
  2. 创建并配置要在部署中使用的 CX Agent Studio 代理应用。
  3. 创建并配置 Google Cloud CCaaS 联络中心，以便在部署中使用。
  4. 按照 CX Agent Studio Google Cloud CCaaS 集成文档中的说明，确保在联络中心实例中启用双向流式传输。
  5. 本指南中的代码段假定您已安装 gcloud CLI 并配置了必要的权限。

将代理应用连接到新的对话配置文件

Google Cloud CCaaS 使用启用了 useBidiStreaming 的对话配置文件与 CX Agent Studio 进行通信。

示例请求

以下示例使用 useBidiStreaming 创建对话配置文件：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • REGION：仅支持 us 和 eu 多区域。
  • DEPLOYMENT_ID：您要与对话配置文件关联的 CX Agent Studio 部署的 ID 值。
  • CONVERSATION_PROFILE_NAME：将此值替换为您要为对话配置文件指定的名称。
curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
        "displayName": "CONVERSATION_PROFILE_NAME",
        "languageCode": "en-US",
        "useBidiStreaming": true,
        "automatedAgentConfig": {
            "agent": "DEPLOYMENT_ID"
        }
      }' \
 https://REGION-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION/conversationProfiles

示例响应

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/global/conversationProfiles/bAp81fGqTg-sp3TUNYTZlw",
  "displayName": "CONVERSATION_PROFILE_NAME",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/global/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "languageCode": "en-US",
  "createTime": "2025-08-21T22:11:12.782515Z",
  "updateTime": "2025-08-21T22:11:12.782515Z",
  "useBidiStreaming": true
}

将代理应用连接到预先存在的对话配置文件

对话配置文件必须与代理应用相关联，并配置为启用 useBidiStreaming。

以下示例使用 useBidiStreaming 创建对话配置文件：

Connect 代理应用示例请求

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • INTEGRATION_ID：在响应中返回。这是新对话配置文件的集成 ID。
  • REGION：仅支持 us 和 eu 多区域。
  • APP_ID：您要与对话个人资料相关联的 CX Agent Studio 代理应用的相关 ID 值。
curl -X PATCH \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"automatedAgentConfig": {"agent": "APP_ID"}}' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=automatedAgentConfig.agent"

Connect 代理应用示例回答

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
  "displayName": "bdsac_us_polysynth_agent",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {},
    "messageAnalysisConfig": {}
  },
  "sttConfig": {
    "model": "telephony",
    "useLongFormModel": true
  },
  "languageCode": "en-US",
  "updateTime": "2025-08-06T21:35:13.388052Z",
  "telephonySttConfig": {}
}

启用 useBidiStreaming 示例请求

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • INTEGRATION_ID：在响应中返回。这是新对话配置文件的集成 ID。
  • REGION：仅支持 us 和 eu 多区域。
curl -X PATCH \
  -H "x-goog-user-project:PROJECT_ID" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{ "useBidiStreaming": true }' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=useBidiStreaming"

启用 useBidiStreaming 示例回答

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
  "displayName": "bdsac_us_polysynth_agent",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {},
    "messageAnalysisConfig": {}
  },
  "sttConfig": {
    "model": "telephony",
    "useLongFormModel": true
  },
  "languageCode": "en-US",
  "updateTime": "2025-08-06T21:54:12.206269Z",
  "telephonySttConfig": {},
  "useBidiStreaming": true
}