Google Cloud CCaaS

Questa guida ti illustra la procedura per connettere un'applicazione agente a un'istanza Google Cloud CCaaS.

Prima di iniziare

  1. Segui i passaggi riportati nella pagina Configurazione e pulizia per creare o configurare il progetto che vuoi utilizzare per l'implementazione. Questo progetto deve essere associato sia all'applicazione dell'agente sia all'istanza Google Cloud CCaaS e deve trovarsi nello stesso region. Controlla il progetto per assicurarti che:
    • La funzionalità Dialogflow API è attivata.
    • Il account di servizio che utilizzerai per il deployment dispone dell'autorizzazione Dialogflow API Admin (roles/dialogflow.admin).
  2. Crea e configura un'applicazione agente CX Agent Studio da utilizzare nel deployment.
  3. Crea e configura un contact center Google Cloud CCaaS da utilizzare nel deployment.
  4. Assicurati che lo streaming bidirezionale sia abilitato nell'istanza del contact center, come indicato nella documentazione relativa all'integrazione di CX Agent Studio e Google Cloud CCaaS.
  5. Gli snippet di codice in questa guida presuppongono che tu abbia installato gcloud CLI e configurato le autorizzazioni necessarie.

Connettere un'applicazione agente a un nuovo profilo di conversazione

Google Cloud CCaaS utilizza un profilo di conversazione con useBidiStreaming attivato per comunicare con CX Agent Studio.

Esempio di richiesta

L'esempio seguente crea un profilo di conversazione con useBidiStreaming:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • REGION: sono supportate solo le multi-regioni us e eu.
  • DEPLOYMENT_ID: il valore ID del deployment di CX Agent Studio che vuoi associare al profilo conversazione.
  • CONVERSATION_PROFILE_NAME: sostituisci questo valore con il nome che vuoi assegnare al profilo di conversazione.
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

Esempio di risposta

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

Collegare un'applicazione agente a un profilo conversazione preesistente

Il profilo di conversazione deve essere associato a un'applicazione agente e configurato per abilitare useBidiStreaming.

L'esempio seguente crea un profilo di conversazione con useBidiStreaming:

Richiesta di esempio dell'applicazione dell'agente Connect

  • PROJECT_ID: l'ID progetto Google Cloud .
  • INTEGRATION_ID: restituito nella risposta. Questo è l'ID integrazione del tuo nuovo profilo conversazione.
  • REGION: sono supportate solo le multi-regioni us e eu.
  • APP_ID: il valore ID dell'applicazione dell'agente CX Agent Studio che vuoi associare al profilo conversazione.
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"

Risposta di esempio dell'applicazione dell'agente 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": {}
}

Abilita la richiesta di esempio useBidiStreaming

  • PROJECT_ID: l'ID progetto Google Cloud .
  • INTEGRATION_ID: restituito nella risposta. Questo è l'ID integrazione del tuo nuovo profilo conversazione.
  • REGION: sono supportate solo le multi-regioni us e 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"

Abilita la risposta di esempio di 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
}