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
}