Questo documento spiega come integrare Contact Center AI Platform (CCAI Platform) con gli agenti di CX Agent Studio.
Crea agenti virtuali CX Agent Studio
Per informazioni sulla creazione di un agente virtuale di Customer Experience Agent Studio, consulta Agenti.
Crea un profilo di conversazione per gli agenti virtuali di CX Agent Studio
Per informazioni su come creare un profilo di conversazione per il tuo agente CX Agent Studio, consulta Collega un'applicazione agente a un nuovo profilo di conversazione.
Creare un account di servizio e una chiave
La piattaforma CCAI si integra con CX Agent Studio utilizzando l'API Dialogflow. Per accedere all'API, devi disporre di un account di servizio account Google Cloude di una chiave associata. Poiché sono specifici del progetto, puoi riutilizzarli se utilizzi più agenti virtuali da un singolo progetto.
I passaggi seguenti illustrano come creare una chiave di servizio inGoogle Cloud. Per ulteriori informazioni sui service account Google, consulta Che cosa sono i service account?
Se hai già creato una chiave di servizio con accesso a CX Agent Studio, puoi saltare questa sezione. Tieni presente che devi inserire una chiave di servizio nel portale della piattaforma CCAI per collegare un agente virtuale di CX Agent Studio.
Per creare un account di servizio, concedi le autorizzazioni corrette e genera una chiave del account di servizio. Segui questi passaggi:
Vai alla consoleGoogle Cloud . Viene mostrato un progetto predefinito.
Nel menu a discesa della barra degli strumenti, seleziona il progetto Google che hai utilizzato per configurare l'agente CX Agent Studio.
Seleziona IAM e amministratore.
Nel menu di navigazione laterale, seleziona Service account. Verrà caricata la console del account di servizio.
Fai clic su +Crea service account.
Inserisci i dettagli del account di servizio in Google Cloud service
Inserisci i dettagli del account di servizio.
Nome visualizzato per questo account di servizio.
L'ID dell'account di servizio è obbligatorio e deve essere univoco.
Descrivi cosa farà questo account di servizio.
Concedi a questo account di servizio l'accesso a un progetto.
Nel menu a discesa Seleziona un ruolo: assegna il ruolo
Dialogflow API Adminal account di servizio.Fai clic su Continua.
Azioni di modifica nella pagina dei service account
La pagina dei service account Google Cloud mostra tutti i service account associati al tuo progetto.

Per creare una chiave del account di servizio, consulta Crea una account di servizio account. Segui le best practice consigliate da Google per l'archiviazione della chiave.
In base al modo in cui la tua azienda gestisce la segmentazione all'interno di Customer Experience Agent Studio, puoi creare più voci della piattaforma di agenti virtuali e aggiungere agenti Customer Experience Agent Studio specifici oppure creare una piattaforma con molti agenti Customer Experience Agent Studio.
Ripeti i passaggi precedenti per ogni agente di Customer Experience Agent Studio di cui devi eseguire l'onboarding nel portale della piattaforma CCAI.
Aggiungi una piattaforma di agenti virtuali
Seleziona questa opzione per eseguire l'onboarding degli agenti virtuali creati utilizzando CX Agent Studio.
Vai a Impostazioni > Impostazioni sviluppatore > Piattaforma agente virtuale.
Fai clic su + Aggiungi piattaforma.
Viene visualizzata la finestra di dialogo Aggiungi una piattaforma di agenti virtuali.

Inserisci un nome per la nuova piattaforma, ad esempio il nome del progetto in cui sono stati creati gli agenti virtuali.
Seleziona uno dei seguenti servizi:
- Conversational Agents / CX Agent Studio
Fai clic su Crea.
Accanto alla nuova piattaforma di agenti virtuali nell'elenco delle piattaforme di agenti virtuali, attiva la piattaforma di agenti virtuali impostandola su On.
Gli agenti virtuali di cui è stato eseguito l'onboarding utilizzando CX Agent Studio utilizzano il metodo BidiStreamingAnalyzeContent, che richiede l'attivazione dello streaming bidirezionale (useBidiStreaming) nel profilo di conversazione.
Stati della piattaforma dell'agente virtuale
La piattaforma CCAI convalida le chiavi dei account di servizio in base alla struttura JSON e alla validità della chiave. Un agente virtuale di CX Agent Studio è completamente autenticato solo quando la sua chiave è nello stato Valida:
Valido: tutti i workflow della piattaforma sono validi.
Richiede attenzione: uno o più workflow nella piattaforma non sono validi. Per risolvere il problema, sostituiscile con chiavi del account di servizio valide.
Non valido: tutti i workflow della piattaforma non sono validi. Quando lo stato di una piattaforma non è valido, la piattaforma viene disattivata automaticamente. Sostituisci le chiavi del account di servizio non valide con chiavi valide per risolvere il problema.
Se lo stato è Non valido o Richiede attenzione, genera chiavi account di servizio per tutte le chiavi non valide e sostituiscile con quelle nuove. Per saperne di più, consulta Crea ed elimina le account di servizio account.
Una volta completati i passaggi di configurazione, gli agenti virtuali sono pronti. Per saperne di più su come gestirli, consulta Assegna agenti virtuali alle code.