Google Cloud CCaaS

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

Prima di iniziare

  1. Segui i passaggi nella pagina di configurazione e pulizia per creare o configurare il progetto che vuoi utilizzare per il deployment. Questo progetto deve essere associato sia all'applicazione agente sia all'istanza Google Cloud CCaaS e deve trovarsi nella stessa region. Controlla il progetto per assicurarti che:
    • Il Dialogflow API sia abilitato.
    • Il account di servizio che utilizzerai per il deployment abbia l'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. Gli snippet di codice in questa guida presuppongono che tu abbia installato la gcloud CLI e configurato le autorizzazioni necessarie.

Connetti un'applicazione agente a un nuovo profilo di conversazione

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

Esempio di richiesta

Il seguente esempio crea un profilo di conversazione con useBidiStreaming:

  • PROJECT_ID: l' Google Cloud ID progetto.
  • REGION: sono supportate solo le multi-regioni us e eu.
  • AGENT_NAME: il nome del deployment o dell'agente CX Agent Studio che vuoi associare al profilo di 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": "AGENT_NAME"
        }
      }' \
 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
}

Connetti un'applicazione agente a un profilo di conversazione preesistente

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

Il seguente esempio crea un profilo di conversazione con useBidiStreaming:

Esempio di richiesta per connettere l'applicazione agente

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

Esempio di risposta per connettere l'applicazione 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": {}
}

Esempio di richiesta per abilitare useBidiStreaming

  • PROJECT_ID: l' Google Cloud ID progetto.
  • INTEGRATION_ID: restituito nella risposta. Questo è l'ID di integrazione del nuovo profilo di 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"

Esempio di risposta per abilitare 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
}