Agente predefinito retail

L'agente predefinito Retail consente agli utenti di cercare articoli, ricevere suggerimenti 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.

Cerca prodotti e acquista articoli

L'utente chiede informazioni sugli smartwatch disponibili nel negozio. L'agente consiglia 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 poi consigli sui numeri di telefono e l'agente suggerisce dei telefoni, ne aggiunge uno al carrello dell'utente ed effettua un ordine.

Input 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 smartwatch hai
Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
sì aggiungine due per favore
È arrivato. Ho aggiunto due smartwatch Google al tuo carrello. Altro?
puoi aggiungere anche un Google Pixel 8 al mio carrello?
È arrivato. Ho aggiunto un Google Pixel 8 al tuo carrello. Altro?
cosa c'è nel mio carrello?
Nel carrello sono presenti un Google Pixel 8 e due Google Watch. Vuoi effettuare il 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?
effettivamente puoi aiutarmi anche a trovare un nuovo telefono?
Abbiamo un telefono Google Pixel 8 e uno smartphone Google Pixel 7, vuoi acquistarne uno?
sì, dammi un Pixel 8
È arrivato. Ho aggiunto uno smartphone Google Pixel 8 al tuo carrello. Altro?
no, possiamo fare il check-out
Hai un telefono Google Pixel 8 nel tuo carrello. Vuoi effettuare il pagamento utilizzando questo carrello?
Ok, ho effettuato un ordine per te. Il tuo ordine contiene un telefono Google Pixel 8. Il numero di conferma è Y43KTF0T.
Posso fare qualcos'altro per aiutarti oggi?
no, è tutto per me, grazie
Ok, grazie per aver acquistato con Google. Ti auguro una buona giornata.

Gestione dei carrelli

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 acquistare un telefono
Abbiamo i telefoni Google Pixel 8 e Google Pixel 7. Quale vuoi acquistare?
dammi due degli 8
È arrivato. Ho aggiunto due smartphone Google Pixel 8 al tuo carrello. Altro?
puoi rimuoverne uno?
Certo, ho rimosso un telefono Google Pixel 8 dal carrello. Altro?
Voglio effettuare l'ordine
Ok, ho effettuato un ordine contenente un telefono Google Pixel 8. Il numero di conferma è X0KP6K5T.
Posso fare qualcos'altro per aiutarti oggi?
no, ecco fatto
Ok, grazie per aver acquistato con Google. Ti auguro una buona giornata.

Prodotto non trovato

L'utente chiede informazioni su un prodotto che non è offerto dal negozio.

Input 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 acquistare un'auto
Spiacenti, non sono disponibili auto. C'è qualcos'altro che vorresti trovare?
sì, che dire degli orologi?
Abbiamo Google Watch. Vuoi aggiungerlo al carrello?
no grazie
Posso fare qualcos'altro per aiutarti oggi?
no
Ok, grazie per aver acquistato con Google. Ti auguro una buona giornata.

Valore non riconosciuto

L'utente chiede informazioni su un argomento non correlato ai prodotti o agli ordini. L'agente risponde ripetendo gli argomenti trattati dall'agente e chiede all'utente come fornire assistenza.

Input 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 telefoni, orologi e cuffie. Posso anche aiutarti a effettuare ordini. Come posso aiutarti oggi?

Configurazione di base

Per configurare questo agente predefinito:

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

Configurazione dello strumento

Questo agente include tools utilizzati per l'integrazione con servizi esterni. Puoi usare il programma di installazione predefinito dello strumento per eseguire il deployment di dati codice campioneio per l'agente predefinito.

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

  1. Scarica il programma di installazione predefinito dello strumento in una directory locale.
  2. Vai alla directory locale in cui hai scaricato installer.zip.
  3. Decomprimi il file 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 l'autenticazione mediante 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:

    Vertex AI Search and Conversation

    1. Se non hai ancora importato l'agente predefinito, importalo nel progetto.
    2. Nella console di Agent Builder, vai alla pagina Ricerca e conversazione.

      Ricerca e conversazione

    3. Seleziona il progetto dal menu a discesa della console.
    4. Selezionare l'app.
    5. Fai clic sull'icona 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 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 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.

Google Store API

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

Gestisci carrello degli acquisti

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

Effettua ordine

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

Completo

L'agente e le sue integrazioni dovrebbero ora essere configurati e pronti per essere testati.