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 illustrano 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 |
|---|---|
| mostrami i sari tradizionali | |
| [Presenta i prodotti] Qualcuno di questi prodotti ti interessa o stai cercando altre opzioni? | |
| Il primo sembra bello | |
| Ottima scelta! Il sari in georgette di seta stampata con design indiano è un capo bellissimo. Poiché i sari sono in genere di taglia unica, ti starà perfettamente. Vuoi aggiungerlo al carrello? | |
| Avete tacchi abbinati? | |
| [Presenta i prodotti] Qualcuno di questi prodotti ti interessa o stai cercando altre opzioni? | |
| Sì, ma puoi leggere le recensioni dei clienti 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 lasciato recensioni contrastanti: alcuni li hanno trovati comodi all'inizio, ma scomodi dopo qualche ora, mentre altri ne hanno elogiato la comodità. I tacchi da donna Glitzy Galz, 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? | |
| Quello con le migliori recensioni e valutazioni | |
| I tacchi da donna Glitzy Galz hanno la valutazione più alta, ovvero 4,5 stelle su 5. Che taglia vuoi scegliere per i tacchi da donna Glitzy Galz? Abbiamo taglie che vanno dalla 35 alla 42. | |
| 6 | |
| Perfetto! I tacchi da donna Glitzy Galz taglia 36 sono stati aggiunti 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 |
|---|---|
| Sta facendo freddo. Avete 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 bambino | |
| [Presenta i prodotti]. Qualcuno di questi prodotti ti interessa o stai cercando altre opzioni? | |
| Aggiungi il primo maglione da donna al carrello | |
| Che taglia vuoi scegliere per il maglione da donna Nineteen Solid Round Neck Casual? Abbiamo taglie che vanno dalla XS alla XL. | |
| M | |
| 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? | |
| Potete consegnarlo il 28 aprile? | |
| Mi dispiace, ma non possiamo consegnare il maglione da donna Nineteen Solid Round Neck Casual il 28 aprile 2024. Il prima possibile per la consegna è il 29 aprile 2024. | |
| Ok, mantieni la data di consegna così com'è | |
| 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: Via Roma 1, 20100 Milano MI | |
| Dati di pagamento: Visa che termina con 4111 Numero di telefono: 416-555-5555 Email: email@example.com Esamina questi dettagli. Se è tutto corretto, conferma. Se devi apportare modifiche, fammelo sapere. |
|
| Il mio indirizzo è cambiato in Via Roma 1, 20100 Milano MI | |
| L'indirizzo di consegna è stato aggiornato a Via Roma 1, 20100 Milano MI. 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. | |
| Grazie | |
| 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 restituzione e fornisce all'utente un'etichetta di reso da stampare e applicare 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 la restituzione. Per iniziare, puoi fornirmi 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 da bambino YK Printed con collo rotondo taglia S. È questo l'articolo che vuoi restituire? | |
| Sì | |
| Ok, ho avviato la procedura di restituzione. Di seguito troverai l'etichetta di reso allegata. Stampala e applicala 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, consulta 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 di 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 multimediali.
Dettagli 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 multimediale.
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 i dati 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 la restituzione è stata avviata dal cliente e che l'ordine è in attesa di restituzione.
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.