Agente predefinito per la vendita al dettaglio

L'agente predefinito basato su playbook per il retail ti consente 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 questi criteri 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 sui telefoni e l'agente suggerisce i telefoni, ne aggiunge uno al carrello dell'utente ed effettua un ordine per l'utente.

Input dell'utente	Risposta dell'agente
ciao
	Ciao, sono il tuo assistente per gli acquisti di Google. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
che orologi avete
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
sì, aggiungine due, per favore
	Fatto. Ho aggiunto due Google Watch al carrello. Altro?
puoi aggiungere anche un Google Pixel 8 al mio carrello?
	Fatto. Ho aggiunto un Google Pixel 8 al 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 un nuovo telefono?
	Abbiamo Google Phone Pixel 8 e Google Phone Pixel 7. Vuoi acquistarne uno?
sì, dammi un Pixel 8
	Fatto. Ho aggiunto un Google Phone Pixel 8 al 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 dell'utente	Risposta dell'agente
ciao, voglio comprare un telefono
	Abbiamo Google Phone Pixel 8 e Google Phone Pixel 7. Quale vuoi acquistare?
dammi due 8
	Fatto. Ho aggiunto due Google Phone Pixel 8 al carrello. Altro?
in realtà, puoi rimuoverne uno?
	Certo, ho rimosso un Google Phone Pixel 8 dal carrello. Altro?
Voglio 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 che il negozio non vende.

Input dell'utente	Risposta dell'agente
ciao
	Ciao, sono il tuo assistente per gli acquisti di 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 ti piacerebbe trovare?
sì, che ne 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 di cosa ha bisogno.

Input dell'utente	Risposta dell'agente
ciao
	Ciao, sono il tuo assistente per gli acquisti di 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 saperne di più, consulta Configurazione degli strumenti.

Configurazione degli strumenti

Questo agente include strumenti per l'integrazione con servizi esterni. Utilizza 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:

   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 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 delle 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 sottoposte a deployment possano accedere a Firestore.

Google Store API

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

Gestire il carrello degli acquisti

Lo strumento Gestisci carrello degli acquisti ti consente di gestire il carrello degli acquisti visualizzando, aggiungendo e rimuovendo articoli.

Effettua ordine

Lo strumento Effettua ordine effettua un ordine con il carrello degli acquisti corrente dell'utente e restituisce un numero di conferma.

Completa

L'agente è configurato e pronto per i test.