Agente predefinito per l'assistente per lo shopping con Vertex AI Search for Retail

L'assistente per gli 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 degli ordini personalizzati, offrendo un'esperienza visiva completa.

Dialoghi di esempio

Le seguenti finestre di dialogo di esempio 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ù apprezzate 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 sari tradizionali
[Presenta i prodotti] Ti interessano alcuni di questi prodotti o cerchi altre opzioni?
La prima foto è buona
Ottima scelta! Il bellissimo sari Georgette di moda stampato Self Design indiano è un capo meraviglioso. Poiché i sari sono in genere di taglia unica, ti staranno perfettamente. Vuoi aggiungerlo al carrello?
Hai anche i tacchi abbinati?
[Presenta i prodotti] Ti interessano alcuni di questi prodotti o cerchi altre opzioni?
Sì, ma puoi esaminare le recensioni dei clienti e scegliere la migliore tra queste?
Le scarpe con tacco Flat n Heels hanno una valutazione media di 4 stelle su 5, mentre le scarpe con tacco Glitzy Galz hanno una valutazione media di 4,5 stelle su 5. Le recensioni dei clienti che hanno acquistato le scarpe con tacco Flat n Heels per donna sono contrastanti: alcuni le hanno trovate comode all'inizio, ma scomode dopo alcune ore, mentre altri le hanno elogiate per 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?
a seconda di quale ha la recensione e le valutazioni migliori
Glitzy Galz Women Heels ha la valutazione più alta di 4,5 stelle su 5. Che taglia vuoi per le scarpe con tacco da donna Glitzy Galz? Le taglie vanno dalla 5 alla 11.
6
Perfetto! Gli stivaletti da donna Glitzy Galz in taglia 6 sono stati aggiunti al carrello con una quantità di 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 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. Hai dei bei maglioni
[Presenta i prodotti]. Ti interessano alcuni di questi prodotti o cerchi altre opzioni?
Mi piace il maglione da donna per mia moglie, ma sto cercando un maglione da ragazzo
[Presenta i prodotti]. Ti interessano alcuni di questi prodotti o cerchi altre opzioni?
Aggiungi il primo maglione da donna al carrello
Quale taglia vuoi per il maglione da donna casual a collo rotondo a tinta unita di Nineteen? Le taglie vanno da XS a XXL.
media
Perfetto! Il maglione da donna casual a collo rotondo a tinta unita di Nineteen nella taglia media è stato aggiunto al carrello con la quantità 1. Vuoi aggiungere qualcos\'altro al carrello?
no
La data più probabile in cui potremo consegnarti il maglione da donna casual a collo rotondo in tinta unita di Nineteen è il 29 aprile 2024. Va bene?
puoi consegnarlo il 28 aprile?
Mi dispiace, ma non siamo in grado di consegnare la maglia da donna casual con scollo rotondo a tinta unita di Nineteen il 28 aprile 2024. La data più probabile è il 29 aprile 2024.
ok, mantieni invariata la data di consegna
Bene, il tuo maglione da donna casual a collo rotondo a tinta unita di Nineteen 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: carta Visa che termina con 4111
Numero di contatto: 416-555-5555
Email: email@example.com
Esamina questi dettagli. Se è tutto corretto, conferma. Se devi apportare modifiche, non esitare a contattarmi.
il mio indirizzo è cambiato in 371 Talbot Street Carmichael, CA 95608
L'indirizzo di consegna è stato aggiornato correttamente in 371 Talbot Street, Carmichael, CA 95608. C'è qualcos'altro che vuoi modificare?
no
Il tuo ordine per la maglia da donna casual a collo rotondo in tinta unita di Nineteen è stato effettuato correttamente con l\'ID ordine ee6b4cc7. La consegna è prevista per il 29 aprile 2024.
grazie
L'ordine è stato inviato correttamente. Posso esserti d'aiuto in altro modo?
No, grazie
Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa di Cymbal Apparel, sono a un solo clic di distanza.\

Verificare lo stato di un ordine

L'utente chiede di controllare lo stato di un ordine. L'agente raccoglie il numero dell'ordine e recupera le informazioni relative all'ordine. L'agente fornisce i dettagli sugli articoli dell'ordine, nonché lo stato attuale e la data di consegna prevista.

Input utente Risposta dell'agente
Gentile
Non esitare a selezionare una delle opzioni sopra indicate o a digitare ciò che stai cercando e ti aiuterò.
Voglio controllare lo stato del mio ordine
Sì, posso aiutarti. Per iniziare, puoi fornirmi il tuo ID ordine?
ee6b4cc7
Il tuo ordine è confermato. Al momento è in corso l'elaborazione.
Ecco cosa hai ordinato:
Maglione da donna casual a collo rotondo a tinta unita Nineteen
Taglia: M
Quantità: 1
Consegna stimata: 29 aprile 2024
C'è altro che posso fare per te?
No, grazie
Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa di Cymbal Apparel, sono a un solo clic di distanza.

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 un'etichetta di reso da stampare e attaccare al pacco.

Input utente Risposta dell'agente
Gentile
Non esitare a selezionare una delle opzioni sopra indicate o a digitare ciò che stai cercando e ti aiuterò.
Voglio restituire il mio ordine
Sono qui per aiutarti con il reso. Per iniziare, puoi condividere 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 da ragazzo con scollo rotondo e stampa YK blu scuro in taglia small. È l\'articolo che vuoi restituire?
OK, ho avviato la procedura di reso. Di seguito troverai l'etichetta di reso allegata. Stampalo e allegalo al pacco prima di restituirlo. Posso esserti d'aiuto in altro modo?
No, grazie
Sono felice di averti potuto aiutare. Se hai bisogno di qualcosa di Cymbal Apparel, sono a un solo clic di distanza.

Impostazione di base

Per configurare questo agente predefinito:

  1. Importa l'agente predefinito.
  2. Configura i strumenti forniti con i tuoi servizi esterni, consulta la sezione Configurazione dello strumento.

Configurazione dello strumento

Questo agente include strumenti utilizzati per l'integrazione con servizi esterni. Per configurare questi strumenti:

  1. Crea un database Firestore denominato apparel-db.
  2. Crea un connettore di integrazione Firestore.
  3. Scarica l'integrazione dell'applicazione per l'assistente Shopping.
  4. Sostituisci tutti i riferimenti a projects/customermod-genai-sa/locations/us-central1/connections/firestore con l'identificatore del connettore creato nel passaggio 2.
  5. Carica e pubblica l'integrazione.
  6. Concedi il ruolo Application Integration Invoker all'agente di servizio Dialogflow.
  7. Aggiorna la proprietà paths in modo che rimandi all'integrazione creata nel passaggio 5 nelle specifiche OpenAPI dei seguenti strumenti: get-order-status, order-lookup, place-order, return-order

Lo strumento search-products recupera i prodotti con la migliore corrispondenza in base alla query di ricerca e al valore dell'offset del catalogo dei prodotti. Lo strumento restituisce una risposta del payload personalizzato che include i dettagli del prodotto. Questo payload personalizzato viene utilizzato dall'interfaccia utente per visualizzare i prodotti sotto forma di contenuti avanzati.

Dettagli prodotto

Lo strumento get-product-details recupera i dettagli del prodotto dal catalogo utilizzando l'API Retail. I dettagli del prodotto recuperati vengono poi trasformati e restituiti in un formato semplificato, utilizzato dall'agente per rispondere alle domande sui prodotti che ha mostrato all'utente

Recensioni prodotto

Lo strumento get-reviews viene utilizzato per recuperare le recensioni dei prodotti. Si aspetta un elenco dei prodotti mostrati e recupera le recensioni per ciascun 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 semplifica 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ù breve.

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, tra cui indirizzo di spedizione, dati di pagamento, numero di telefono ed email, mentre lo strumento update-user-info è responsabile dell'aggiornamento delle informazioni dell'utente.

Gestione degli ordini

Lo strumento place-order gestisce la procedura di inserimento di un ordine per gli articoli del carrello acquisti. Memorizza l'ordine in Firestore con i dati dell'ordine, tra cui ID ordine, stato, timestamp di creazione e elenco di prodotti. Restituisce il numero d'ordine all'agente.

Lo strumento order-lookup recupera i dati degli ordini da un database Firestore in base all'ID ordine fornito.

Lo strumento return-order aggiorna lo stato di un ordine in "return_pending" nel database Firestore, indicando che la restituzione è stata avviata dal cliente e che l'ordine è in attesa di una 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.