CCaaS do Google Cloud

Este guia orienta você no processo de conexão de 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 de agente e à instância do CCaaS do Google Cloud e estar na mesma region. Verifique se o projeto atende aos seguintes requisitos:
    • A Dialogflow API está ativada.
    • 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 do CCaaS do Google Cloud para usar na implantação.
  4. Verifique se o streaming bidirecional está ativado na sua instância da central de atendimento, conforme instruído na documentação de integração do CCaaS do Google Cloud do CX Agent Studio.
  5. 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 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 Google Cloud projeto do.
  • REGION: somente as multirregiões us e eu são compatíveis.
  • DEPLOYMENT_ID: o valor do ID da implantação 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": "DEPLOYMENT_ID"
        }
      }' \
 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 useBidiStreaming.

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

Exemplo de solicitação de aplicativo de agente de conexão

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

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

Exemplo de solicitação de useBidiStreaming

  • PROJECT_ID: o ID do Google Cloud projeto do.
  • INTEGRATION_ID: retornado na resposta. Esse é o ID de integração do 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"

Exemplo de resposta de 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
}