Agente predefinito per la vendita al dettaglio

L'agente predefinito basato sul playbook per il retail consente agli utenti di cercare articoli, ricevere consigli sui prodotti ed effettuare un ordine.

Esempi di dialoghi

I seguenti esempi di dialoghi mostrano scenari comuni gestiti da questo agente predefinito.

Cercare prodotti e acquistare articoli

L'utente chiede informazioni sugli orologi disponibili nel negozio. L'agente consiglia i prodotti che soddisfano questo criterio e l'utente li aggiunge al carrello degli acquisti. L'utente conferma di voler effettuare un ordine e l'agente conferma l'ordine con un numero di conferma. L'utente richiede quindi consigli sugli smartphone e l'agente suggerisce alcuni modelli, ne aggiunge uno al carrello dell'utente ed effettua un ordine per l'utente.

Input utente	Risposta dell'agente
ciao
	Ciao. Sono il tuo assistente per gli acquisti su Google. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
quali orologi avete
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
sì, aggiungine due, per favore
	Esatto. Ho aggiunto due Google Watch al tuo carrello. Altro?
puoi aggiungere anche un Google Pixel 8 al mio carrello?
	Esatto. Ho aggiunto un Google Pixel 8 al tuo carrello. Altro?
cosa c'è nel mio carrello?
	Nel carrello hai un Google Pixel 8 e due Google Watch. Vuoi pagare?
sì, per favore
	Ok, ho effettuato un ordine contenente un Google Pixel 8 e due Google Watch. Il numero di conferma è QKA67DW2.
	Posso fare qualcos'altro per aiutarti oggi?
in realtà, puoi aiutarmi a trovare anche uno smartphone nuovo?
	Abbiamo Google Phone Pixel 8 e Google Phone Pixel 7. Vuoi acquistare uno di questi modelli?
sì, dammi un Pixel 8
	Esatto. Ho aggiunto un Google Phone Pixel 8 al tuo carrello. Altro?
no, possiamo pagare
	Nel carrello hai un Google Phone Pixel 8. Vuoi pagare utilizzando questo carrello?
sì
	Ok, ho effettuato un ordine per te. L'ordine contiene un Google Phone Pixel 8. Il numero di conferma è Y43KTF0T.
	Posso fare qualcos'altro per aiutarti oggi?
no, è tutto, grazie
	Ok, grazie per aver fatto acquisti su Google. Ti auguro una buona giornata.

Gestione del carrello

L'utente chiede di aggiungere alcuni articoli al carrello, quindi ne rimuove uno prima di effettuare un ordine.

Input utente	Risposta dell'agente
ciao, voglio comprare uno smartphone
	Abbiamo Google Phone Pixel 8 e Google Phone Pixel 7. Quale vuoi acquistare?
dammi due modelli 8
	Esatto. Ho aggiunto due Google Phone Pixel 8 al tuo carrello. Altro?
in realtà, puoi rimuoverne uno?
	Certo, ho rimosso un Google Phone Pixel 8 dal tuo carrello. Altro?
Sono pronto a effettuare l'ordine
	Ok, ho effettuato un ordine contenente un Google Phone Pixel 8. Il numero di conferma è X0KP6K5T.
	Posso fare qualcos'altro per aiutarti oggi?
no, è tutto
	Ok, grazie per aver fatto acquisti su Google. Ti auguro una buona giornata.

Prodotto non trovato

L'utente chiede informazioni su un prodotto non disponibile nel negozio.

Input utente	Risposta dell'agente
ciao
	Ciao. Sono il tuo assistente per gli acquisti su Google. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
voglio comprare un'auto
	Mi dispiace, non abbiamo auto disponibili. C'è qualcos'altro che vorresti trovare?
sì, cosa mi dici degli orologi?
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
no, grazie
	Posso fare qualcos'altro per aiutarti oggi?
no
	Ok, grazie per aver fatto acquisti su Google. Ti auguro una buona giornata.

Valore non riconosciuto

L'utente pone una domanda su un argomento non correlato a prodotti o ordini. L'agente risponde ripetendo gli argomenti trattati e chiede all'utente in cosa può aiutarlo.

Input utente	Risposta dell'agente
ciao
	Ciao. Sono il tuo assistente per gli acquisti su Google. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
voglio prenotare un hotel
	Mi dispiace, non posso aiutarti con questa richiesta. Posso aiutarti a cercare prodotti, tra cui smartphone, orologi e cuffie. Posso anche aiutarti a effettuare ordini. Come posso aiutarti oggi?

Impostazione di base

Per configurare questo agente predefinito:

1. Importa l'agente predefinito.
2. Configura gli strumenti forniti con i tuoi servizi esterni. Per maggiori informazioni, consulta la sezione Configurazione degli strumenti.

Configurazione degli strumenti

Questo agente include strumenti utilizzati per l'integrazione con servizi esterni. Puoi utilizzare il programma di installazione degli strumenti predefiniti per eseguire il deployment di codice campione e dati per l'agente predefinito.

Per eseguire il deployment e configurare codice campione e dati per l'agente predefinito Retail, espandi per visualizzare le istruzioni.

1. Scarica il programma di installazione degli strumenti predefiniti in una directory locale.
2. Vai alla directory locale in cui hai scaricato installer.zip.
3. Decomprimi installer.zip e apri la cartella installer.
4. Consulta il file README.md per una panoramica dettagliata del programma di installazione e dei relativi requisiti.
5. Esegui pip install -r requirements.txt per installare i requisiti.
6. Esegui gcloud auth application-default login per eseguire l'autenticazione utilizzando gcloud auth.
7. Esegui il programma di installazione utilizzando python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail
8. Dopo aver eseguito il deployment di tutti i servizi richiesti, configura ogni strumento nell'agente predefinito con gli URL forniti registrati dal programma di installazione:

   Console Vertex AI Agent Builder

   1. Se non hai ancora importato l'agente predefinito, importalo nel tuo progetto.
   2. Vai alla console Vertex AI Agent Builder.

      Console Vertex AI Agent Builder

   3. Seleziona il tuo progetto dal menu a discesa della console.
   4. Seleziona l'app.
   5. Fai clic sull'icona Strumenti.
   6. Per ogni strumento nell'agente, modifica lo schema per sostituire l'URL nel servers: campo con l'endpoint registrato dal programma di installazione.
   7. Fai clic su Salva.

   Dialogflow CX

   1. Se non hai ancora importato l'agente predefinito, importalo nel tuo progetto.
   2. Apri la console Dialogflow CX.
   3. Scegli il tuo progetto Google Cloud.
   4. Seleziona l'agente.
   5. Fai clic sull'icona Risorse generative.
   6. Fai clic su Strumenti.
   7. Per ogni strumento nell'agente, modifica lo schema per sostituire l'URL nel servers campo con l'endpoint registrato dal programma di installazione.
   8. Fai clic su Salva.
9. Concedi al account di servizio Compute Engine (your-project-number-developer.gserviceaccount.com) il ruolo Utente Cloud Datastore, in modo che le funzioni Cloud Run appena implementate possano accedere a Firestore.

Google Store API

Lo strumento Google Store API viene utilizzato per recuperare articoli dal Google Store in base a un termine di ricerca.

Gestire il carrello degli acquisti

Lo strumento Manage Shopping Cart consente all'utente di gestire il proprio carrello degli acquisti visualizzando tutti gli articoli nel carrello, aggiungendo articoli al carrello e rimuovendo articoli dal carrello.

Effettua ordine

Lo strumento Place Order viene utilizzato per effettuare un ordine con il carrello degli acquisti corrente dell'utente e restituisce un numero di conferma per l'ordine effettuato.

Completa

L'agente e le relative integrazioni dovrebbero essere configurati e pronti per il test.