Agente predefinito per la vendita al dettaglio

L'agente predefinito basato su playbook di Retail consente agli utenti di cercare articoli, ricevere consigli sui prodotti ed effettuare un ordine.

Finestre di dialogo di esempio

Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo agente predefinito.

Cercare prodotti e acquistare articoli

L'utente chiede informazioni sugli smartwatch disponibili nel negozio. L'agente consiglia prodotti che soddisfano questo criterio e l'utente li aggiunge al carrello. 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 alcuni modelli, ne aggiunge uno al carrello dell'utente ed effettua un ordine per suo conto.

Input utente	Risposta dell'agente
ciao
	Ciao, sono il tuo assistente per 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
	Certo. Ho aggiunto due Google Watch al tuo carrello. Altro?
puoi aggiungere anche un Google Pixel 8 al mio carrello?
	Certo. 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 tuo numero di conferma è QKA67DW2.
	Posso fare qualcos'altro per aiutarti oggi?
In realtà, puoi aiutarmi a trovare anche un nuovo smartphone?
	Abbiamo Google Pixel 8 e Google Pixel 7. Vuoi acquistarne uno?
Sì, dammi un Pixel 8
	Certo. Ho aggiunto uno smartphone Google Pixel 8 al carrello. Altro?
no we can check out
	Nel carrello hai un Google Pixel 8. Vuoi pagare utilizzando questo carrello?
sì
	Ok, ho effettuato un ordine per te. Il tuo ordine contiene uno smartphone Google Pixel 8. Il tuo numero di conferma è Y43KTF0T.
	Posso fare qualcos'altro per aiutarti oggi?
no, per me è tutto, grazie
	Ok, grazie per aver effettuato acquisti con Google. Ti auguro una buona giornata.

Gestione del carrello

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

Input utente	Risposta dell'agente
ciao, voglio comprare uno smartphone
	Abbiamo Google Pixel 8 e Google Pixel 7. Quale vuoi acquistare?
dammi due degli 8
	Certo. Ho aggiunto due Google Pixel 8 al carrello. Altro?
in realtà puoi rimuoverne uno?
	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 tuo numero di conferma è X0KP6K5T.
	Posso fare qualcos'altro per aiutarti oggi?
no, è tutto
	Ok, grazie per aver effettuato acquisti con 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 Google Shopping. Posso aiutarti a cercare articoli ed effettuare ordini. Come posso aiutarti oggi?
Voglio comprare un'auto
	Siamo spiacenti, non abbiamo auto in magazzino. C'è qualcos'altro che vorresti trovare?
Sì, e gli orologi?
	Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
no, grazie
	Posso fare qualcos'altro per aiutarti oggi?
no
	Ok, grazie per aver effettuato acquisti con 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 che tratta e chiede all'utente di cosa ha bisogno.

Input utente	Risposta dell'agente
ciao
	Ciao, sono il tuo assistente per 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:

1. Importa l'agente predefinito.
2. Configura gli strumenti forniti con i tuoi servizi esterni. Vedi Configurazione degli strumenti.

Configurazione dello strumento

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 e dati di esempio per l'agente predefinito.

Per eseguire il deployment e configurare il codice e i dati di esempio per l'agente predefinito 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:

   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 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 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 il tuo 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 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 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

Lo strumento Manage Shopping Cart consente all'utente di gestire il carrello degli acquisti visualizzando tutti gli articoli nel carrello, aggiungendone e rimuovendone.

Effettua ordine

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

Completa

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