Google Cloud CCaaS

In dieser Anleitung wird beschrieben, wie Sie eine Agent-Anwendung mit einer Google Cloud CCaaS Instanz verbinden.

Hinweis

  1. Folgen Sie der Anleitung auf der Seite Einrichtung und Bereinigung , um das Projekt zu erstellen oder zu konfigurieren, das Sie für die Bereitstellung verwenden möchten. Dieses Projekt muss sowohl mit Ihrer Agent-Anwendung als auch mit der Google Cloud CCaaS-Instanz verknüpft sein und sich in derselben region befinden. Prüfen Sie in Ihrem Projekt, ob Folgendes zutrifft:
    • Die Dialogflow API ist aktiviert.
    • Das Dienstkonto, das Sie für die Bereitstellung verwenden, hat die Berechtigung Dialogflow API Admin (roles/dialogflow.admin).
  2. Erstellen und konfigurieren Sie eine CX Agent Studio-Agent-Anwendung, die Sie für die Bereitstellung verwenden möchten.
  3. Erstellen und konfigurieren Sie ein Google Cloud CCaaS-Contact Center, das Sie für die Bereitstellung verwenden möchten.
  4. Achten Sie darauf, dass bidirektionales Streaming in Ihrer Contact Center-Instanz aktiviert ist, wie in der CX Agent Studio Google Cloud CCaaS Integration Dokumentation beschrieben.
  5. In den Code-Snippets in dieser Anleitung wird davon ausgegangen, dass Sie die gcloud CLI installiert und die erforderlichen Berechtigungen konfiguriert haben.

Agent-Anwendung mit einem neuen Unterhaltungsprofil verbinden

Google Cloud CCaaS verwendet ein Unterhaltungsprofil mit useBidiStreaming aktiviert, um mit CX Agent Studio zu kommunizieren.

Beispielanfrage

Im folgenden Beispiel wird ein Unterhaltungsprofil mit useBidiStreaming erstellt:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • REGION: Es werden nur die Multiregionen us und eu unterstützt.
  • DEPLOYMENT_ID: Der ID-Wert der CX Agent Studio-Bereitstellung, die Sie mit dem Unterhaltungsprofil verknüpfen möchten.
  • CONVERSATION_PROFILE_NAME: Ersetzen Sie diesen Wert durch den Namen, den Sie dem Unterhaltungsprofil geben möchten.
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

Beispielantwort

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

Agent-Anwendung mit einem vorhandenen Unterhaltungsprofil verbinden

Das Unterhaltungsprofil muss mit einer Agent-Anwendung verknüpft und so konfiguriert sein, dass useBidiStreaming aktiviert ist.

Im folgenden Beispiel wird ein Unterhaltungsprofil mit useBidiStreaming erstellt:

Beispielanfrage zum Verbinden einer Agent-Anwendung

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • INTEGRATION_ID: In der Antwort zurückgegeben. Dies ist die Integrations-ID Ihres neuen Unterhaltungsprofils.
  • REGION: Es werden nur die Multiregionen us und eu unterstützt.
  • APP_ID: Der ID-Wert der CX Agent Studio-Agent-Anwendung, die Sie mit dem Unterhaltungsprofil verknüpfen möchten.
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"

Beispielantwort zum Verbinden einer Agent-Anwendung

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

Beispielanfrage zum Aktivieren von useBidiStreaming

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • INTEGRATION_ID: In der Antwort zurückgegeben. Dies ist die Integrations-ID Ihres neuen Unterhaltungsprofils.
  • REGION: Es werden nur die Multiregionen us und eu unterstützt.
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"

Beispielantwort zum Aktivieren von 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
}