L'assistente per gli acquisti è un agente predefinito basato su playbook che fornisce query sui prodotti di vendita al dettaglio, ordini, stato degli ordini e annullamento degli ordini. Utilizza Agent Search for Retail e payload di fulfillment personalizzati per offrire un'esperienza visiva completa.
Esempio di dialogo
Questa finestra di dialogo di esempio mostra gli scenari comuni gestiti da questo agente predefinito.
Confronto di prodotti e recensioni
- L'utente chiede di sfogliare i sari tradizionali.
- L'agente presenta alcune opzioni popolari e l'utente seleziona la prima.
- L'utente chiede scarpe abbinate.
- L'agente presenta alcune opzioni popolari e l'utente chiede di confrontare le recensioni e seleziona l'opzione con la valutazione più alta.
- L'agente chiede la taglia e conferma che le scarpe sono state aggiunte al carrello.
| Input utente | Risposta dell'agente |
|---|---|
| fammi vedere i sari tradizionali | |
| [Presenta i prodotti] Qualcuno di questi prodotti attira il tuo interesse o stai cercando altre opzioni? | |
| Il primo è perfetto | |
| Ottima scelta! Il sari in georgette stampato Indian Beauty Self Design è un bellissimo capo. Poiché i sari sono in genere di taglia unica, si adatteranno perfettamente. Vuoi aggiungerlo al carrello? | |
| Hai dei tacchi abbinati? | |
| [Presenta i prodotti] Qualcuno di questi prodotti attira il tuo interesse o stai cercando altre opzioni? | |
| Sì, ma puoi esaminare la recensione del cliente e scegliere la migliore tra queste? | |
| I tacchi da donna Flat n Heels hanno una valutazione media di 4 stelle su 5, mentre i tacchi da donna Glitzy Galz hanno una valutazione media di 4,5 stelle su 5. I clienti che hanno acquistato i tacchi da donna Flat n Heels hanno espresso recensioni contrastanti: alcuni li hanno trovati comodi all'inizio, ma scomodi dopo poche ore, mentre altri ne hanno elogiato il comfort. I tacchi da donna Glitzy Galz, invece, hanno ricevuto recensioni per lo più positive, con i clienti che ne hanno elogiato la vestibilità, la qualità e il design. Quale vuoi aggiungere al carrello? | |
| quello con le recensioni e le valutazioni migliori | |
| I tacchi da donna Glitzy Galz hanno la valutazione più alta, ovvero 4,5 stelle su 5. Che taglia vuoi per i tacchi da donna Glitzy Galz? Abbiamo taglie dalla 35 alla 41. | |
| 6 | |
| Perfetto! Le scarpe con tacco da donna Glitzy Galz, taglia 36, sono state aggiunte al carrello (quantità: 1). C'è qualcos'altro che vuoi aggiungere al carrello? |
Esperienza di acquisto end-to-end
- L'utente sfoglia il catalogo dei prodotti.
- L'agente presenta i consigli in base alla richiesta dell'utente.
- Dopo alcune ricerche, l'utente trova un articolo da acquistare.
- L'agente conferma la taglia e la quantità dell'articolo da acquistare, nonché la data di consegna prevista.
- L'utente richiede una data di consegna diversa, che non è disponibile, e accetta la data di consegna originale.
- L'agente conferma i dati di consegna, pagamento e contatto registrati.
- L'utente aggiorna le informazioni di consegna e conferma.
- L'agente effettua l'ordine e fornisce all'utente il numero dell'ordine.
| Input utente | Risposta dell'agente |
|---|---|
| Sta diventando freddo. Hai dei bei maglioni? | |
| [Presenta i prodotti]. Qualcuno di questi prodotti ti interessa o stai cercando altre opzioni? | |
| Mi piace il maglione da donna per mia moglie, ma sto cercando un maglione da ragazzo | |
| [Presenta i prodotti]. Qualcuno di questi prodotti ti interessa o stai cercando altre opzioni? | |
| aggiungi il primo maglione da donna al carrello | |
| Che taglia vorresti per il maglione casual da donna Nineteen con scollo tondo in tinta unita? Abbiamo taglie che vanno dalla XS alla XL. | |
| media | |
| Perfetto! Il maglione casual da donna Nineteen Solid con scollo tondo, taglia M, è stato aggiunto al carrello (quantità: 1). C'è qualcos'altro che vuoi aggiungere al carrello? | |
| no | |
| La data più vicina in cui possiamo consegnarti il maglione Nineteen Solid girocollo casual da donna è il 29 aprile 2024. Che ne pensi? | |
| puoi consegnarlo il 28 aprile? | |
| Siamo spiacenti, ma non siamo in grado di consegnare il maglione casual da donna Nineteen con scollo tondo in tinta unita il 28 aprile 2024. La prima data di consegna possibile è il 29 aprile 2024. | |
| ok, mantieni la data di consegna così com'è | |
| Ok, il tuo maglione casual da donna Nineteen Solid con scollo tondo verrà consegnato il 29 aprile 2024. Ora esaminiamo i dettagli del tuo profilo per assicurarci che tutto sia aggiornato:\ | |
| Indirizzo di consegna: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Dati di pagamento: Visa che termina con 4111 Numero di contatto: 416-555-5555 Email: email@example.com Controlla questi dettagli. Se è tutto corretto, conferma. Se devi apportare modifiche, fammelo sapere. |
|
| il mio indirizzo è cambiato in 371 Talbot Street Carmichael, CA 95608 | |
| Il tuo indirizzo di consegna è stato aggiornato correttamente a 371 Talbot Street, Carmichael, CA 95608. C'è qualcos'altro che vorresti modificare? | |
| no | |
| Il tuo ordine per il maglione casual da donna Nineteen Solid con scollo tondo è stato effettuato correttamente con l'ID ordine ee6b4cc7. La consegna è prevista per il 29 aprile 2024. | |
| grazie | |
| Il tuo ordine è stato effettuato. Posso esserti d'aiuto in altro modo? | |
| no grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, sono a tua disposizione.\ |
Controllare lo stato di un ordine
- L'utente richiede di controllare lo stato di un ordine.
- L'agente raccoglie il numero dell'ordine e recupera le informazioni sull'ordine.
- L'agente fornisce i dettagli sugli articoli dell'ordine e sulla data di consegna prevista.
| Input utente | Risposta dell'agente |
|---|---|
| Gentile | |
| Puoi scegliere tra le opzioni riportate sopra o semplicemente digitare ciò che stai cercando e ti aiuterò. | |
| Voglio controllare lo stato del mio ordine | |
| Sì, posso aiutarti. Per iniziare, puoi fornirmi l'ID ordine? | |
| ee6b4cc7 | |
| Il tuo ordine è confermato. Al momento è in fase di elaborazione. Ecco cosa hai ordinato: Maglione casual da donna Nineteen tinta unita con scollo tondo Taglia: M Quantità: 1 Consegna stimata: 29 aprile 2024 Posso aiutarti con qualcos'altro? |
|
| No, grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, sono a tua disposizione. |
Restituzione di un ordine
- L'utente vuole restituire un ordine.
- L'agente raccoglie il numero dell'ordine, recupera i dettagli dell'ordine e conferma l'articolo da restituire.
- L'agente avvia la procedura di reso e fornisce un'etichetta di reso che l'utente deve stampare e applicare al pacco.
| Input utente | Risposta dell'agente |
|---|---|
| Gentile | |
| Puoi scegliere tra le opzioni riportate sopra o semplicemente digitare ciò che stai cercando e ti aiuterò. | |
| Voglio restituire il mio ordine | |
| Sono qui per aiutarti con il tuo reso. Per iniziare, potresti condividere con me il numero dell'ordine? | |
| 0fc77d64 | |
| Grazie per aver fornito il numero dell'ordine. Ho trovato il tuo ordine effettuato il 12 aprile 2024. L'ordine contiene una t-shirt YK stampata da ragazzo con scollo tondo, blu scuro, taglia S. È questo l'articolo che vuoi restituire? | |
| sì | |
| Ok, ho avviato la procedura di reso. L'etichetta di reso è allegata di seguito. Stampala e attaccala al pacco prima di spedirlo. Posso esserti d'aiuto in altro modo? | |
| No, grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, sono a tua disposizione. |
Impostazione di base
Per configurare questo agente predefinito:
- Importa l'agente predefinito.
- Configura gli strumenti forniti con i tuoi servizi esterni. Per saperne di più, consulta Configurazione dello strumento.
Configurazione dello strumento
Questo agente include strumenti utilizzati per l'integrazione con servizi esterni. Per configurare questi strumenti, segui questi passaggi:
- Crea un database Firestore denominato
apparel-db. - Crea un connettore di integrazione Firestore.
- Scarica l'integrazione delle applicazioni per l'assistente agli acquisti.
- Sostituisci tutti i riferimenti a
projects/customermod-genai-sa/locations/us-central1/connections/firestorecon l'identificatore del connettore creato nel passaggio 2. - Carica e pubblica l'integrazione.
- Concedi il ruolo
Cloud Functions Invokeral tuo agente di servizio Dialogflow. - Segui i passaggi per configurare il catalogo di Retail.
- Aggiorna i controlli degli attributi per rendere recuperabili i seguenti campi: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, URI.
- Importa il catalogo di esempio nel ramo 1 del tuo catalogo e impostalo come ramo predefinito.
- Scarica la funzione Cloud Run e aggiorna
config.toml. - Segui i passaggi per eseguire il deployment della funzione Cloud Run.
- Concedi il ruolo IAM
Retail Vieweralla funzione Cloud Run di cui hai eseguito il deployment. - Per i seguenti strumenti:
get-order-status,order-lookup,place-orderereturn-order, aggiorna la proprietàpathsin modo che faccia riferimento all'integrazione che hai creato nel passaggio 5 nelle specifiche OpenAPI e scegli Autenticazione service account con un account di servizio a cui concedi il ruoloApplication Integration Invoker. - Aggiorna la proprietà dell'URL del server alla funzione Cloud Run di cui hai eseguito il deployment per gli strumenti rimanenti.
Strumento Ricerca prodotti
Lo strumento search-products recupera i prodotti con la migliore corrispondenza in base alla query di ricerca e al valore di offset dal catalogo dei prodotti. Lo strumento restituisce una risposta con payload personalizzato che include i dettagli del prodotto. Questo payload personalizzato viene utilizzato dalla UI per visualizzare i prodotti sotto forma di contenuti avanzati.
Strumento Ottieni dettagli del prodotto
Lo strumento get-product-details recupera i dettagli del prodotto dal catalogo dei prodotti
utilizzando l'API AI Commerce Search. Il sistema trasforma e restituisce i dettagli del prodotto recuperati in un formato semplificato, che l'agente utilizza per rispondere alle domande sui prodotti mostrati all'utente.
Strumento per ricevere recensioni
Lo strumento get-reviews recupera le recensioni dei prodotti. Prevede un elenco di prodotti mostrati e recupera le recensioni per ogni prodotto. Le recensioni generate vengono trasformate in un formato di modello personalizzato (review_template) adatto alla visualizzazione in un'interfaccia utente avanzata.
Strumento Prodotti simili
Lo strumento similar-products facilita la scoperta di prodotti simili a un prodotto specificato utilizzando l'API Retail Recommendation. Accetta un ID prodotto e utilizza l'API Retail Recommendation per prevedere prodotti simili dal catalogo dei prodotti.
Strumenti per la data di consegna
Lo strumento store-delivery-date è responsabile della memorizzazione della data di consegna preferita dall'utente per gli articoli nel carrello, che deve essere confrontata con la data di consegna stimata più vicina.
Lo strumento get-delivery-date stima la data di consegna degli articoli nel carrello.
Strumento Get User Info
Lo strumento get-user-info recupera le informazioni personali dell'utente, tra cui
indirizzo di spedizione, dati di pagamento, numero di telefono e indirizzo email. Lo strumento update-user-info aggiorna le informazioni dell'utente.
Strumento Effettua ordine
Lo strumento place-order effettua un ordine per gli articoli nel carrello. Archivia i dati dell'ordine in Firestore, inclusi l'ID ordine, lo stato, il timestamp di creazione e l'elenco dei prodotti, quindi restituisce il numero dell'ordine all'agente.
Strumento di ricerca degli ordini
Lo strumento order-lookup recupera i dati dell'ordine da un database Firestore utilizzando l'ID ordine fornito e restituisce le informazioni sull'ordine all'agente.
Strumento per la restituzione degli ordini
Lo strumento return-order aggiorna lo stato di un ordine impostandolo su "return_pending" nel database Firestore, a indicare che è stato avviato un reso e che è in attesa.
Strumento Ottieni lo stato dell'ordine
Lo strumento get-order-status recupera lo stato di un ordine e, se l'ordine viene spedito, lo monitora utilizzando l'API DHL. Fornisce messaggi appropriati in base allo stato dell'ordine.
Completa
Ora l'agente e le sue integrazioni dovrebbero essere configurati e pronti per il test.