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 Agent アプリケーションのサンプル レスポンス

{
  "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
}