CCaaS de Google Cloud

En esta guía, se explica el proceso para conectar una aplicación de agente a una instancia de CCaaS de Google Cloud.

Antes de comenzar

  1. Sigue los pasos de la página de configuración y limpieza para crear o configurar el proyecto que deseas usar para la implementación. Este proyecto debe estar asociado con tu aplicación de agente y la instancia de CCaaS de Google Cloud, y debe estar en la misma region. Revisa tu proyecto para asegurarte de lo siguiente:
    • La Dialogflow API está habilitada.
    • La cuenta de servicio que usarás para la implementación tiene el permiso Dialogflow API Admin (roles/dialogflow.admin).
  2. Crea y configura una aplicación de agente de CX Agent Studio para usarla en la implementación.
  3. Crea y configura un centro de contacto de CCaaS de Google Cloud para usarlo en la implementación.
  4. Asegúrate de que la transmisión bidireccional esté habilitada en tu instancia de centro de contacto, como se indica en la documentación de integración de CCaaS de Google Cloud de CX Agent Studio.
  5. En los fragmentos de código de esta guía, se supone que tienes instalada la CLI de gcloud y que se configuraron los permisos necesarios.

Conecta una aplicación de agente a un perfil de conversación nuevo

CCaaS de Google Cloud usa un perfil de conversación con useBidiStreaming habilitado para comunicarse con CX Agent Studio.

Solicitud de ejemplo

En el siguiente ejemplo, se crea un perfil de conversación con useBidiStreaming:

  • PROJECT_ID: Es el ID del Google Cloud proyecto.
  • REGION: Solo se admiten las multirregiones us y eu.
  • DEPLOYMENT_ID: Es el valor de ID de la implementación de CX Agent Studio que deseas asociar con el perfil de conversación.
  • CONVERSATION_PROFILE_NAME: Reemplaza este valor por el nombre que deseas asignarle al perfil de conversación.
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

Respuesta de ejemplo

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

Conecta una aplicación de agente a un perfil de conversación preexistente

El perfil de conversación debe estar asociado con una aplicación de agente y configurado para habilitar useBidiStreaming.

En el siguiente ejemplo, se crea un perfil de conversación con useBidiStreaming:

Solicitud de ejemplo de conexión de aplicación de agente

  • PROJECT_ID: Es el ID del Google Cloud proyecto.
  • INTEGRATION_ID: Se muestra en la respuesta. Este es el ID de integración de tu nuevo perfil de conversación.
  • REGION: Solo se admiten las multirregiones us y eu.
  • APP_ID: Es el valor de ID de la aplicación de agente de CX Agent Studio que deseas asociar con el perfil de conversación.
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"

Respuesta de ejemplo de conexión de aplicación de agente

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

Solicitud de ejemplo para habilitar useBidiStreaming

  • PROJECT_ID: Es el ID del Google Cloud proyecto.
  • INTEGRATION_ID: Se muestra en la respuesta. Este es el ID de integración de tu nuevo perfil de conversación.
  • REGION: Solo se admiten las multirregiones us y 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"

Respuesta de ejemplo para habilitar 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
}