L'assistente agli acquisti agente predefinito basato su playbook fornisce query sui prodotti di vendita al dettaglio, ordini, stato degli ordini e annullamento degli ordini. Utilizza Vertex AI Search for Retail e payload di evasione personalizzati, offrendo una ricca esperienza visiva.
Esempi di dialoghi
I seguenti esempi di dialoghi mostrano scenari comuni gestiti da questo agente predefinito.
Confronto tra 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 le opzioni più richieste 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 |
|---|---|
| show me traditional sarees | |
| [Presents products] Do any of these products catch your interest, or are you after different options? | |
| 1st one is looking good | |
| Ottima scelta! Il sari in georgette di seta stampata con motivo indiano è un capo bellissimo. Poiché i sari sono in genere taglia unica, ti starà perfettamente. Vuoi aggiungerlo al carrello? | |
| do you have a matching heels with it? | |
| [Presents products] Do any of these products catch your interest, or are you after different options? | |
| yes but can you go through the customer review and pick the best one from these | |
| Le scarpe con tacco Flat n Heels da donna hanno una valutazione media di 4 stelle su 5, mentre le scarpe con tacco Glitzy Galz da donna hanno una valutazione media di 4,5 stelle su 5. I clienti che hanno acquistato le scarpe con tacco Flat n Heels da donna hanno lasciato recensioni contrastanti: alcuni le hanno trovate comode all'inizio, ma scomode dopo qualche ora, mentre altri ne hanno elogiato la comodità. Le scarpe con tacco Glitzy Galz da donna, invece, hanno ricevuto recensioni per lo più positive, con clienti che ne hanno elogiato la vestibilità, la qualità e il design. Quale vuoi aggiungere al carrello? | |
| whichever has the best review and ratings | |
| Le scarpe con tacco Glitzy Galz da donna hanno la valutazione più alta, ovvero 4,5 stelle su 5. Che taglia vuoi scegliere per le scarpe con tacco Glitzy Galz da donna? Abbiamo taglie che vanno dalla 35 alla 42. | |
| 6 | |
| Perfetto! Le scarpe con tacco Glitzy Galz da donna taglia 36 sono state aggiunte al carrello con 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 i dati di consegna e conferma. L'agente effettua l'ordine e fornisce all'utente il numero dell'ordine.
| Input utente | Risposta dell'agente |
|---|---|
| It is getting cold. Do you have good sweaters | |
| [Presents products]. Do any of these products catch your interest, or are you after different options? | |
| I like the women's sweater for my wife, but i am looking for a boy's sweater | |
| [Presents products]. Do any of these products catch your interest, or are you after different options? | |
| add the first women's sweater to the cart | |
| Che taglia vuoi scegliere per il maglione da donna Nineteen Solid Round Neck Casual? Abbiamo taglie che vanno dalla XS alla XL. | |
| medium | |
| Perfetto! Il maglione da donna Nineteen Solid Round Neck Casual taglia M è stato aggiunto al carrello con quantità 1. C'è qualcos'altro che vuoi aggiungere al carrello? | |
| no | |
| Il prima possibile per la consegna del maglione da donna Nineteen Solid Round Neck Casual è il 29 aprile 2024. Ti va bene? | |
| can you deliver it on April 28? | |
| Mi dispiace, ma non possiamo consegnare il maglione da donna Nineteen Solid Round Neck Casual il 28 aprile 2024. Il prima possibile è il 29 aprile 2024. | |
| ok keep the delivery date as it is | |
| Ok, il maglione da donna Nineteen Solid Round Neck Casual verrà consegnato il 29 aprile 2024. Ora esaminiamo i dettagli del tuo profilo per assicurarci che siano aggiornati: | |
| Indirizzo di consegna: 638 Maple Street, Apt 11, Cupertino, CA 95014 | |
| Dati di pagamento: Visa con numero finale 4111 Numero di contatto: 416-555-5555 Email: email@example.com Esamina questi dettagli. Se è tutto corretto, conferma. Se devi apportare modifiche, fammelo sapere. |
|
| my address has changed to 371 Talbot Street Carmichael, CA 95608 | |
| L'indirizzo di consegna è stato aggiornato a 371 Talbot Street, Carmichael, CA 95608. C'è qualcos'altro che vuoi modificare? | |
| no | |
| L'ordine per il maglione da donna Nineteen Solid Round Neck Casual è stato effettuato correttamente con l'ID ordine ee6b4cc7. La consegna è prevista per il 29 aprile 2024. | |
| thanks | |
| L'ordine è stato effettuato correttamente. Posso esserti d'aiuto in altro modo? | |
| no, grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, basta un clic. |
Controllare lo stato di un ordine
L'utente chiede di controllare lo stato di un ordine. L'agente raccoglie il numero dell'ordine e recupera i dati dell'ordine. L'agente fornisce dettagli sugli articoli dell'ordine, nonché sullo stato attuale e sulla data di consegna prevista.
| Input utente | Risposta dell'agente |
|---|---|
| Gentile | |
| Seleziona una delle opzioni sopra o digita quello 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. È in fase di elaborazione. Ecco cosa hai ordinato: Maglione da donna Nineteen Solid Round Neck Casual Taglia: M Quantità: 1 Consegna stimata: 29 aprile 2024 Posso esserti d'aiuto in altro modo? |
|
| No, grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, basta un clic. |
Restituire 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 quindi la procedura di reso e fornisce all'utente un'etichetta di reso da stampare e attaccare al pacco.
| Input utente | Risposta dell'agente |
|---|---|
| Gentile | |
| Seleziona una delle opzioni sopra o digita quello che stai cercando e ti aiuterò. | |
| Voglio restituire il mio ordine | |
| Sono qui per aiutarti con il reso. Per iniziare, puoi comunicarmi 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 blu scuro con collo rotondo e stampa YK da bambino taglia S. È questo l'articolo che vuoi restituire? | |
| sì | |
| Ok, ho avviato la procedura di reso. Di seguito troverai l'etichetta di reso allegata. Stampala e attaccala al pacco prima di rispedirlo. Posso esserti d'aiuto in altro modo? | |
| No, grazie | |
| Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa da Cymbal Apparel, basta un clic. |
Impostazione di base
Per configurare questo agente predefinito:
- Importa l'agente predefinito.
- Configura gli strumenti forniti con i tuoi servizi esterni, vedi Configurazione degli strumenti.
Configurazione degli strumenti
Questo agente include strumenti utilizzati per l'integrazione con servizi esterni. Per configurare questi strumenti:
- Crea un
database Firestore
denominato
apparel-db. - Crea un connettore di integrazione Firestore.
- Scarica l'Application Integration 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 i ruoli
Cloud Functions Invokerall'agente di servizio Dialogflow. - Segui i passaggi per configurare il catalogo 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 catalogo e impostalo come ramo predefinito.
- Scarica la funzione Cloud Run disponibile
qui
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 creata nel passaggio 5 nelle specifiche OpenAPI e scegli l'autenticazione dell'account di servizio 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.
Product Search
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 di payload personalizzata che include i dettagli del prodotto.
Questo payload personalizzato viene utilizzato dall'interfaccia utente per visualizzare i prodotti in formato di contenuti avanzati.
Dettagli del prodotto
Lo strumento get-product-details recupera i dettagli del prodotto dal catalogo dei prodotti utilizzando l'API Retail.
I dettagli del prodotto recuperati vengono quindi trasformati e restituiti in un formato semplificato, utilizzato dall'agente per rispondere alle domande sui prodotti che ha mostrato all'utente.
Recensioni di prodotti
Lo strumento get-reviews viene utilizzato per recuperare le recensioni dei prodotti.
Si aspetta 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.
Prodotti simili
Lo strumento similar-products facilita il rilevamento 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.
Data di consegna
Lo strumento store-delivery-date è responsabile della memorizzazione della data di consegna preferita dall'utente per gli articoli nel carrello degli acquisti, che deve essere confrontata con la data di consegna stimata più vicina.
Lo strumento get-delivery-date è responsabile della stima della data di consegna degli articoli nel carrello degli acquisti.
Dettagli utente
Lo strumento get-user-info recupera le informazioni personali dell'utente, inclusi indirizzo di spedizione, dati di pagamento, numero di telefono ed email, mentre lo strumento update-user-info è responsabile dell'aggiornamento dei dati dell'utente.
Gestione degli ordini
Lo strumento place-order gestisce la procedura di effettuazione di un ordine per gli articoli del carrello degli acquisti.
Memorizza l'ordine in Firestore con i dati dell'ordine, inclusi ID ordine, stato, timestamp di creazione ed elenco dei prodotti.
Restituisce il numero dell'ordine all'agente.
Lo strumento order-lookup recupera i dati dell'ordine da un database Firestore in base all'ID ordine fornito.
Lo strumento return-order aggiorna lo stato di un ordine a "return_pending" nel database Firestore, indicando che il reso è stato avviato dal cliente e che l'ordine è in attesa di reso.
Lo strumento get-order-status è responsabile del recupero dello stato di un ordine e, se l'ordine è stato spedito, del monitoraggio utilizzando l'API DHL.
Fornisce messaggi appropriati in base allo stato dell'ordine.
Completa
L'agente e le relative integrazioni dovrebbero essere configurati e pronti per il test.