1. Panoramica
Cosa creerai
In questo codelab, utilizzerai la funzionalità Agente datastore in Vertex AI Conversation per creare, configurare ed eseguire il deployment di un agente virtuale in grado di assistere i clienti che hanno domande sui prodotti e sui dispositivi del Google Store, inclusi smartphone, smartwatch, laptop, dispositivi per la smart home e altri dispositivi di consumo.
Che cos'è un agente del data store?
Un agente datastore è una funzionalità di Vertex AI Conversation basata sulle funzionalità di Dialogflow CX.
Con un agente datastore, puoi fornire un URL di un sito web, dati strutturati o dati non strutturati. L'agente datastore analizza i contenuti e crea un agente virtuale basato su datastore e modelli linguistici di grandi dimensioni. I tuoi clienti e utenti finali possono quindi conversare con l'agente e porre domande sui contenuti. Per saperne di più, consulta la documentazione dell'agente datastore.

Obiettivi didattici
- Come creare un agente del datastore
- Come aggiungere dati non strutturati al datastore dell'agente
- Come attivare le esperienze vocali e di chat per l'agente
- Come testare l'agente e simulare le domande dei clienti
- Come visualizzare la cronologia delle conversazioni e le analisi per il tuo agente
Che cosa ti serve
- Un progetto Google Cloud
- Un browser come Chrome
2. Abilita API
Prima di poter iniziare a utilizzare un agente datastore in Vertex AI Conversation, devi abilitare le API Dialogflow e Vertex AI Search and Conversation.
Per abilitare l'API Dialogflow:
- Nel browser, vai alla pagina dei dettagli del servizio API Dialogflow.
- Fai clic sul pulsante Abilita per abilitare l'API Dialogflow nel tuo progetto Google Cloud.
Per abilitare l'API Vertex AI Search and Conversation:
- Nella console Google Cloud, vai alla console Vertex AI Search and Conversation.
- Leggi e accetta i Termini di servizio, quindi fai clic su Continua e attiva l'API.
3. Crea una nuova app di chat
Ora creerai una nuova app di chat per l'agente virtuale e la configurerai con un'origine dati. Lo scopo dell'agente che creerai è quello di assistere i clienti che hanno domande sui prodotti del Google Store.
Utilizzerai la console Vertex AI Conversation e la console Dialogflow CX per eseguire i passaggi rimanenti di questo codelab per creare, configurare ed eseguire il deployment di un agente virtuale in grado di gestire domande e risposte utilizzando un agente datastore.
- Per creare una nuova app di chat in Vertex AI Conversation, puoi:
- Vai alla console Vertex AI Conversation, quindi fai clic su + Nuova app nella parte superiore della console.
- Vai alla console Dialogflow CX, fai clic su +Crea nuovo agente, seleziona l'opzione Genera automaticamente e poi verrà visualizzato il passaggio successivo nella console Vertex AI Conversation.
- Nella console Vertex AI Conversation, seleziona Chat come tipo di app da creare.
- Inserisci un nome dell'azienda di
Google Store. Questo parametro viene utilizzato per definire l'azienda che il tuo agente rappresenta e l'ambito del tuo agente. - Specifica un nome dell'agente di
Google Store. - Fai clic su Continua.
- Fai clic su Crea nuovo datastore.
- Seleziona Cloud Storage come origine dati per il datastore.
- Specifica la seguente cartella Google Cloud Storage che contiene i dati di esempio per questo codelab e tieni presente che il prefisso
gs://non è obbligatorio:cloud-samples-data/dialogflow-cx/google-store - Seleziona Documenti non strutturati come tipo di dati da importare.
- Fai clic su Continua.
- Specifica un nome datastore di
Google Store. - Fai clic su Crea per creare il datastore.
- Nell'elenco dei datastore, seleziona
Google Storeappena creato. - Fai clic su Crea per creare la tua app di chat.
Complimenti! Hai finito di creare la tua app di chat basata sulla conoscenza, pronta ad aiutare i tuoi clienti, quindi prenditi un momento per festeggiare.
Ma c'è ancora molto da fare per rendere il bot accessibile ai tuoi utenti. Nella sezione successiva, testerai il tuo agente virtuale e vedrai quanto è bravo a rispondere alle domande degli utenti su vari prodotti del Google Store.
4. Testare l'agente virtuale
I test sono una parte importante del lavoro con gli agenti conversazionali per trovare bug, identificare limitazioni e simulare un'esperienza cliente. Puoi avviare una sessione interattiva con il tuo chatbot per vedere come risponde a varie domande che un cliente potrebbe porre.
- Dalla console Vertex AI Conversation, fai clic sul nome della tua app di chat, che ti reindirizzerà alla console Dialogflow CX per ulteriori test e personalizzazioni.
- Nella console Dialogflow CX e all'interno dell'agente, fai clic su Test Agent (Testa agente) per aprire il simulatore.

- Digita un saluto per l'agente, ad esempio
Hello. - Poni all'operatore alcune domande su vari prodotti, ad esempio:
How long does the battery in the Pixel 7 Pro last?Is the Pixel Watch water resistant?Can I display my Google Photos on a Nest Hub?- Poni altre domande su campanelli, termostati, luci smart o altri dispositivi nel Google Store.

Ottimo! Tieni presente che l'agente virtuale conosce molti prodotti diversi nel Google Store, poiché ha acquisito informazioni dal dominio principale che hai specificato in precedenza. Per scoprire di più su come testare l'agente, consulta la documentazione relativa al simulatore di agenti.
5. Attivare le chiamate vocali
Ora che hai testato l'agente e sei soddisfatto del suo attuale livello di funzionalità, puoi aggiungere un gateway telefonico al bot, che utilizzerà le funzionalità di Speech-to-Text e Text-to-Speech in Google Cloud.
- Nella console Dialogflow CX e all'interno dell'agente, fai clic sulla scheda Gestisci nella barra laterale, poi su Integrazioni.
- Fai clic su Gestisci nella sezione CX Phone Gateway nella parte superiore della pagina Integrazioni.

- Nella pagina Numeri di telefono, fai clic su Crea nuovo per iniziare la procedura di creazione di un nuovo numero di telefono per il tuo agente virtuale.
- Seleziona un codice paese e fai clic su Richiedi per continuare con il passaggio successivo.
- Seleziona uno dei numeri di telefono visualizzati, inserisci un nome visualizzato, quindi fai clic su Salva.
- Chiama il tuo agente e fagli qualche domanda.
Do the Pixel 7 Pro and Pixel 7 both have face unlock?What coverage does Preferred Care provide for a Pixelbook Go laptop?Do the Pixel Buds Pro have active noise cancellation?- Poni altre domande su campanelli, termostati, luci smart o altri dispositivi nel Google Store.
Congratulazioni, hai dato al tuo agente virtuale un numero di telefono e una voce propri. Per saperne di più su altre integrazioni di voce e telefonia disponibili, consulta la documentazione relativa alle integrazioni di Dialogflow CX.
Successivamente, integrerai un messenger di chat per il tuo agente virtuale in un sito web esterno.
6. Attivare il widget di chat
Ora che il bot ha un gateway telefonico per le interazioni vocali, incorporiamo un widget di chat in un sito web in modo che i clienti possano chattare con lui oltre a telefonare per parlare con lui.
- Nella console Dialogflow CX e all'interno dell'agente, fai clic sulla scheda Gestisci nella barra laterale, poi su Integrazioni.
- Fai clic su Connetti in Dialogflow Messenger.
- Fai clic su Attiva nella finestra di dialogo, quindi copia il codice HTML per l'integrazione della messaggistica.
- Apri un editor di codice online come CodePen o JSFiddle e incolla il codice HTML di Dialogflow Messenger.
- Prova e chatta con il tuo agente virtuale. Ecco alcune domande di esempio da porre:
Do the Pixel 7 Pro and Pixel 7 both have face unlock?How does Preferred Care relate to a Pixelbook Go laptop?Do the Pixel Buds Pro have noise cancellation?- Poni altre domande su campanelli, termostati, luci smart o altri dispositivi nel Google Store.
Ora il tuo agente virtuale può gestire domande e risposte dei tuoi clienti tramite chat o voce, a seconda delle loro preferenze. Per saperne di più sulle altre integrazioni di chat disponibili, consulta la documentazione relativa alle integrazioni di Dialogflow CX.

7. Analisi conversazionale
Quando testi il tuo agente virtuale, se ritieni che le risposte del bot non soddisfino le tue aspettative, puoi sempre aggiungere altri URL al datastore per migliorare la gestione di domande e risposte.
Oltre a testare molti percorsi diversi che i clienti potrebbero intraprendere, in che altro modo puoi determinare dove si trovano i problemi e i punti di attrito nel tuo agente virtuale? La cronologia delle conversazioni e le analisi possono aiutarti.
- Nella console Dialogflow CX e all'interno dell'agente, fai clic su Impostazioni agente nel menu.

- Nelle impostazioni Logging, seleziona Abilita cronologia delle conversazioni.

- Avvia una conversazione con il tuo bot tramite il simulatore di agenti, l'integrazione vocale o l'integrazione della chat e fagli qualche domanda.
- Dopo aver terminato la conversazione con l'agente, nella console Dialogflow CX e all'interno dell'agente, fai clic sulla scheda Gestisci nella barra laterale, poi su Cronologia conversazioni.

- Fai clic su una delle conversazioni recenti, quindi esamina la conversazione e annota la durata, le risposte fornite dall'agente e gli intent che sono stati abbinati durante la conversazione.

- Nella console Dialogflow CX e all'interno dell'agente, fai clic sulla scheda Gestisci nella barra laterale, quindi fai clic su Analytics. Man mano che i clienti interagiscono con il tuo agente, questa pagina mostrerà un riepilogo di varie statistiche relative alle richieste e alle risposte dell'agente.
Bene. Ora sai come esaminare conversazioni specifiche in modo più dettagliato e rivedere altre metriche relative alle risposte degli agenti e alle interazioni con i clienti. Per saperne di più sulla valutazione del rendimento e sulla visualizzazione delle metriche per il tuo agente, consulta la documentazione relativa alla cronologia delle conversazioni e all'analisi delle conversazioni.
Questi dati ti aiutano a valutare come viene utilizzato l'agente in produzione e possono essere utilizzati per determinare quali siti web e documenti potresti voler aggiungere alla tua knowledge base per migliorare l'agente e l'esperienza dei clienti.
8. Complimenti
Utilizzando Vertex AI Conversation e Dialogflow CX, hai creato un agente datastore, aggiunto origini dati ed eseguito il deployment di un agente abilitato alla voce e alla chat per aiutare i tuoi clienti.
Il tuo agente virtuale può rispondere a centinaia di domande diverse sui prodotti del Google Store e non hai dovuto eseguire la procedura manuale di creazione di un numero elevato di intent, frasi di addestramento, messaggi di risposta e così via.
Prova altri tipi di dati nei tuoi datastore ed esplora le altre funzionalità disponibili relative a Vertex AI Conversation e Dialogflow CX.

Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo codelab, puoi eseguire la seguente pulizia:
- Per evitare addebiti Google Cloud non necessari, utilizza la console Google Cloud per eliminare il progetto se non ti serve.
- Se hai utilizzato un progetto Google Cloud esistente, elimina le risorse che hai creato per evitare addebiti sul tuo account. Per saperne di più, consulta i passaggi per eliminare un'app.
- Se vuoi disabilitare le API per Vertex AI Conversation e Dialogflow, vai alla pagina dei dettagli del servizio API Discovery Engine, fai clic su Disabilita API e conferma, quindi vai alla pagina dei dettagli del servizio API Dialogflow, fai clic su Disabilita API e conferma.
Scopri di più
Continua a scoprire l'AI conversazionale e l'AI generativa con queste guide e risorse:
- Panoramica di Vertex AI Conversation
- Creare e utilizzare gli agenti del datastore
- Documentazione di Dialogflow CX
- Documentazione per gli agenti del datastore
- AI generativa in Google Cloud
Licenza
Questo lavoro è concesso in licenza ai sensi di una licenza Creative Commons Attribution 2.0 Generic.