Google Cloud CCaaS

Ce guide vous explique comment connecter une application d'agent à une instance Google Cloud CCaaS.

Avant de commencer

  1. Suivez les étapes de la page Configuration et nettoyage pour créer ou configurer le projet que vous souhaitez utiliser pour le déploiement. Ce projet doit être associé à la fois à votre application d'agent et à votre instance Google Cloud CCaaS, et se trouver dans le même region. Vérifiez les points suivants dans votre projet :
    • La fonctionnalité Dialogflow API est activée.
    • Le compte de service que vous utiliserez pour le déploiement dispose de l'autorisation Dialogflow API Admin (roles/dialogflow.admin).
  2. Créez et configurez une application d'agent CX Agent Studio à utiliser dans le déploiement.
  3. Créez et configurez un centre de contact Google Cloud CCaaS à utiliser dans le déploiement.
  4. Assurez-vous que le streaming bidirectionnel est activé dans votre instance de centre de contact, comme indiqué dans la documentation sur l'intégration de CX Agent Studio à Google Cloud CCaaS.
  5. Les extraits de code de ce guide supposent que vous avez installé la gcloud CLI et configuré les autorisations nécessaires.

Associer une application d'agent à un nouveau profil de conversation

Google Cloud CCaaS utilise un profil de conversation avec useBidiStreaming activé pour communiquer avec CX Agent Studio.

Exemple de requête

L'exemple suivant crée un profil de conversation avec useBidiStreaming :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • REGION : seuls les emplacements multirégionaux us et eu sont acceptés.
  • DEPLOYMENT_ID : valeur de l'ID du déploiement CX Agent Studio que vous souhaitez associer au profil de conversation.
  • CONVERSATION_PROFILE_NAME : remplacez cette valeur par le nom que vous souhaitez attribuer au profil de conversation.
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

Exemple de réponse

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

Associer une application d'agent à un profil de conversation préexistant

Le profil de conversation doit être associé à une application d'agent et configuré pour activer useBidiStreaming.

L'exemple suivant crée un profil de conversation avec useBidiStreaming :

Exemple de demande d'application d'agent Connect

  • PROJECT_ID : ID de votre projet Google Cloud .
  • INTEGRATION_ID : renvoyé dans la réponse. Il s'agit de l'ID d'intégration de votre nouveau profil de conversation.
  • REGION : seuls les emplacements multirégionaux us et eu sont acceptés.
  • APP_ID : valeur de l'ID de l'application d'agent CX Agent Studio que vous souhaitez associer au profil de conversation.
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"

Exemple de réponse de l'application de l'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": {}
}

Activer l'exemple de requête useBidiStreaming

  • PROJECT_ID : ID de votre projet Google Cloud .
  • INTEGRATION_ID : renvoyé dans la réponse. Il s'agit de l'ID d'intégration de votre nouveau profil de conversation.
  • REGION : seuls les emplacements multirégionaux us et eu sont acceptés.
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"

Activer l'exemple de réponse 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
}