CCaaS do Google Cloud

Este guia mostra como conectar um aplicativo de agente a uma instância do CCaaS do Google Cloud.

Antes de começar

  1. Siga as etapas na página de configuração e limpeza para criar ou configurar o projeto que você quer usar na implantação. Esse projeto precisa estar associado ao aplicativo do agente e à instância do CCaaS do Google Cloud e estar na mesma region. Verifique se o projeto tem o seguinte:
    • O Dialogflow API está ativado.
    • A conta de serviço que você vai usar para a implantação tem a permissão Dialogflow API Admin (roles/dialogflow.admin).
  2. Crie e configure um aplicativo de agente do CX Agent Studio para usar na implantação.
  3. Crie e configure uma central de atendimento CCaaS do Google Cloud para usar na implantação.
  4. Os snippets de código neste guia pressupõem que você tenha a CLI gcloud instalada e as permissões necessárias configuradas.

Conectar um aplicativo de agente a um novo perfil de conversa

O CCaaS do Google Cloud usa um perfil de conversa com o useBidiStreaming ativado para se comunicar com o CX Agent Studio.

Exemplo de solicitação

O exemplo a seguir cria um perfil de conversa com useBidiStreaming:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • REGION: somente as multirregiões us e eu são compatíveis.
  • AGENT_NAME: o nome da implantação ou do agente do CX Agent Studio que você quer associar ao perfil de conversa.
  • CONVERSATION_PROFILE_NAME: substitua esse valor pelo nome que você quer dar ao perfil de conversa.
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

Exemplo de resposta

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

Conectar um aplicativo de agente a um perfil de conversa preexistente

O perfil de conversa precisa estar associado a um aplicativo de agente e configurado para ativar o useBidiStreaming.

O exemplo a seguir cria um perfil de conversa com useBidiStreaming:

Exemplo de solicitação de aplicativo do agente do Connect

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • INTEGRATION_ID: retornado na resposta. Esse é o ID de integração do seu novo perfil de conversa.
  • REGION: somente as multirregiões us e eu são compatíveis.
  • APP_ID: o valor do ID do aplicativo do agente do CX Agent Studio que você quer associar ao perfil de conversa.
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"

Exemplo de resposta do aplicativo do agente do 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": {}
}

Ativar a solicitação de amostra useBidiStreaming

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • INTEGRATION_ID: retornado na resposta. Esse é o ID de integração do seu novo perfil de conversa.
  • REGION: somente as multirregiões us e eu são compatíveis.
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"

Ativar a resposta de amostra 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
}