Google Cloud CCaaS

In diesem Leitfaden wird beschrieben, wie Sie eine Agentenanwendung 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 Agentenanwendung als auch mit der Google Cloud CCaaS-Instanz verknüpft sein und sich in derselben region befinden. Prüfen Sie in Ihrem Projekt Folgendes:
    • 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-Agentenanwendung, die in der Bereitstellung verwendet werden soll.
  3. Erstellen und konfigurieren Sie ein Google Cloud CCaaS-Contact Center, das in der Bereitstellung verwendet werden soll.
  4. Bei den Code-Snippets in diesem Leitfaden wird davon ausgegangen, dass Sie die gcloud CLI installiert und die erforderlichen Berechtigungen konfiguriert haben.

KI-Agent-Anwendung mit einem neuen Unterhaltungsprofil verbinden

Google Cloud CCaaS verwendet ein Unterhaltungsprofil mit aktivierter useBidiStreaming für die Kommunikation mit CX Agent Studio.

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.
  • AGENT_NAME: Der Name der CX Agent Studio-Bereitstellung oder des Agenten, den Sie dem Konversationsprofil zuordnen 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": "AGENT_NAME"
        }
      }' \
 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 für useBidiStreaming konfiguriert sein.

Im folgenden Beispiel wird ein Unterhaltungsprofil mit useBidiStreaming erstellt:

Beispielanfrage für Connect Agent-Anwendung

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • INTEGRATION_ID: Wird 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-Agentenanwendung, die Sie dem Unterhaltungsprofil zuordnen 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 für die Connect 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": {}
}

useBidiStreaming-Beispielanfrage aktivieren

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • INTEGRATION_ID: Wird 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"

useBidiStreaming-Beispielantwort aktivieren

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