Agente predefinito per la vendita al dettaglio

L'agente predefinito basato su playbook per la vendita al dettaglio ti consente di cercare articoli, ricevere consigli sui prodotti ed effettuare un ordine.

Esempio di dialogo

Questa finestra di dialogo di esempio mostra gli scenari comuni gestiti da questo agente predefinito.

Cercare prodotti e acquistare articoli

1. L'utente chiede informazioni sugli orologi disponibili nel negozio.
2. L'agente consiglia i prodotti che soddisfano questi criteri.
3. L'utente aggiunge il prodotto al carrello.
4. L'utente aggiunge un altro prodotto al carrello.
5. L'utente chiede informazioni sui contenuti del carrello.
6. L'agente elenca gli articoli nel carrello e l'utente conferma di volerli acquistare.
7. L'agente effettua l'ordine e fornisce un numero di conferma.
8. L'utente chiede un consiglio per uno smartphone.
9. L'agente consiglia gli smartphone disponibili in negozio.
10. L'utente ne aggiunge uno al carrello.
11. L'utente effettua un ordine per lo smartphone e fornisce un numero di conferma.

Input utente	Risposta dell'agente
Gentile
	Ciao, sono il tuo assistente Google Shopping. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
quali smartwatch hai
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
sì, aggiungine due per favore
	Risposta esatta. Ho aggiunto due Google Watch al tuo carrello. Altro?
puoi aggiungere anche un Google Pixel 8 al mio carrello?
	Risposta esatta. 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 procedere al pagamento?
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 anche a trovare un nuovo smartphone?
	Abbiamo lo smartphone Google Pixel 8 e lo smartphone Google Pixel 7. Vuoi acquistarne uno?
Sì, dammi un Pixel 8
	Risposta esatta. Ho aggiunto uno smartphone Google Pixel 8 al tuo carrello. Altro?
no, possiamo fare il checkout
	Hai uno smartphone Google Pixel 8 nel carrello. Vuoi fare il checkout utilizzando questo carrello?
sì
	Ok, ho effettuato un ordine per te. Il tuo ordine contiene uno smartphone Google Pixel 8. Il numero di conferma è Y43KTF0T.
	Posso fare qualcos'altro per aiutarti oggi?
no, è tutto, grazie
	Ok, grazie per aver scelto Google per i tuoi acquisti. Ti auguro una buona giornata.

Gestione del carrello

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

Input utente	Risposta dell'agente
Ciao, voglio acquistare uno smartphone
	Abbiamo lo smartphone Google Pixel 8 e lo smartphone Google Pixel 7. Quale vuoi acquistare?
dammi due degli 8
	Risposta esatta. Ho aggiunto due smartphone Google Pixel 8 al tuo carrello. Altro?
actually can you remove one of them?
	Certo, ho rimosso uno smartphone Google Pixel 8 dal tuo carrello. Altro?
Voglio effettuare l'ordine
	Ok, ho effettuato un ordine contenente uno smartphone Google Pixel 8. Il numero di conferma è X0KP6K5T.
	Posso fare qualcos'altro per aiutarti oggi?
no, è tutto
	Ok, grazie per aver scelto Google per i tuoi acquisti. Ti auguro una buona giornata.

Prodotto non trovato

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

Input utente	Risposta dell'agente
Gentile
	Ciao, sono il tuo assistente Google Shopping. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
Voglio acquistare un'auto
	Spiacenti, non abbiamo auto disponibili. C'è qualcos'altro che vorresti trovare?
Sì, e gli smartwatch?
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
no grazie
	Posso fare qualcos'altro per aiutarti oggi?
no
	Ok, grazie per aver scelto Google per i tuoi acquisti. Ti auguro una buona giornata.

Input non riconosciuto

1. L'utente chiede informazioni su un argomento non correlato ai prodotti o agli ordini.
2. L'agente risponde ripetendo gli argomenti che tratta e chiede all'utente per cosa ha bisogno di aiuto.

Input utente	Risposta dell'agente
Gentile
	Ciao, sono il tuo assistente Google Shopping. 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, smartwatch e cuffie. Posso anche aiutarti a effettuare ordini. Come posso aiutarti oggi?

Impostazione di base

Per configurare questo agente predefinito, segui questi passaggi:

1. Importa l'agente predefinito.
2. Configura gli strumenti forniti con i tuoi servizi esterni. Per saperne di più, consulta Configurazione dello strumento.

Configurazione dello strumento

Questo agente include strumenti per l'integrazione con servizi esterni. Esegui il deployment di codice campione e dati per l'agente predefinito utilizzando il programma di installazione dello strumento.

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

1. Scarica il programma di installazione dello strumento predefinito 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 autenticarti 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:

   Generative AI App Builder

   1. Se non hai ancora importato l'agente predefinito, importalo nel tuo progetto.
   2. Vai a Generative AI App Builder.

      Generative AI App Builder

   3. Seleziona il tuo progetto dal menu a discesa della console.
   4. Selezionare l'app.
   5. Fai clic sull'icona degli strumenti.
   6. Per ogni strumento dell'agente, modifica lo schema per sostituire l'URL nel campo servers: 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 dell'agente, modifica lo schema per sostituire l'URL nel campo servers 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 di cui è stato eseguito il deployment di recente possano accedere a Firestore.

Strumento API Google Store

Lo strumento API Google Store recupera gli articoli dal Google Store in base a un termine di ricerca.

Strumento Gestisci carrello

Lo strumento Gestisci carrello consente all'utente di gestire il carrello visualizzando, aggiungendo e rimuovendo articoli.

Strumento Effettua ordine

Lo strumento Place Order effettua un ordine per il carrello corrente dell'utente e restituisce un numero di conferma.

Completa

L'agente è configurato e pronto per il test.