Vordefinierter Shopping Assistant-Agent mit Vertex AI Search for Retail

Der auf Playbooks basierende vordefinierte Agent für den Einkaufsassistenten bietet Funktionen für Einzelhandelsproduktanfragen, Bestellungen, Bestellstatus und Stornierungen. Er verwendet Vertex AI Search for Retail und benutzerdefinierte Fulfillment-Nutzlasten, um eine ansprechende visuelle Erfahrung zu bieten.

Beispieldialoge verfassen

Die folgenden Beispieldialoge zeigen gängige Szenarien, die von diesem vordefinierten Agenten behandelt werden.

Produkt- und Rezensionsvergleich

Der Nutzer möchte traditionelle Saris ansehen. Der Agent präsentiert einige beliebte Optionen und der Nutzer wählt die erste aus. Der Nutzer fragt nach passenden Schuhen. Der Agent präsentiert beliebte Optionen und der Nutzer möchte Rezensionen vergleichen und wählt die am besten bewertete Option aus. Der Agent fragt nach der Größe und bestätigt, dass die Schuhe in den Einkaufswagen gelegt wurden.

Nutzereingabe Antwort des KI-Agenten
Zeig mir traditionelle Saris
[Präsentiert Produkte] Ist eines dieser Produkte für dich interessant oder suchst du nach anderen Optionen?
Der erste sieht gut aus
Das ist eine gute Wahl. Der Sari „Indian Beauty Self Design, Printed Fashion Georgette“ ist ein wunderschönes Kleidungsstück. Da Saris in der Regel eine Einheitsgröße haben, passt er perfekt. Möchtest du ihn in den Einkaufswagen legen?
Gibt es dazu passende Schuhe?
[Präsentiert Produkte] Ist eines dieser Produkte für dich interessant oder suchst du nach anderen Optionen?
Ja, aber kannst du die Kundenrezensionen durchgehen und die beste auswählen?
Die Damenschuhe „Flat n Heels“ haben eine durchschnittliche Bewertung von 4 von 5 Sternen, während die Damenschuhe „Glitzy Galz“ eine durchschnittliche Bewertung von 4,5 von 5 Sternen haben. Kunden, die die Damenschuhe „Flat n Heels“ gekauft haben, haben gemischte Rezensionen abgegeben. Einige fanden sie anfangs bequem, nach ein paar Stunden jedoch unbequem, während andere den Komfort lobten. Die Damenschuhe „Glitzy Galz“ erhielten dagegen überwiegend positive Rezensionen, wobei Kunden die Passform, Qualität und das Design lobten. Welche möchtest du in den Einkaufswagen legen?
Die mit der besten Rezension und Bewertung
Die Damenschuhe „Glitzy Galz“ haben die höchste Bewertung von 4,5 von 5 Sternen. Welche Größe möchtest du bei den Damenschuhen „Glitzy Galz“? Wir haben Größen von 36 bis 46.
6
Perfekt! Die Damenschuhe „Glitzy Galz“ in Größe 39 wurden mit der Menge 1 in deinen Einkaufswagen gelegt. Möchtest du noch etwas in den Einkaufswagen legen?

End-to-End-Einkaufserlebnis

Der Nutzer durchsucht den Produktkatalog. Der Agent präsentiert Empfehlungen basierend auf der Anfrage des Nutzers. Nach einigen Suchanfragen findet der Nutzer einen Artikel, den er kaufen möchte. Der Agent bestätigt die Größe und Menge des zu kaufenden Artikels sowie den voraussichtlichen Liefertermin. Der Nutzer fragt nach einem anderen Lieferdatum, das nicht verfügbar ist, und stimmt dem ursprünglichen Lieferdatum zu. Der Agent bestätigt die hinterlegten Liefer-, Zahlungs- und Kontaktdaten. Der Nutzer aktualisiert die Lieferinformationen und bestätigt. Der Agent gibt die Bestellung auf und teilt dem Nutzer die Bestellnummer mit.

Nutzereingabe Antwort des KI-Agenten
Es wird kalt. Habt ihr gute Pullover?
[Präsentiert Produkte]. Ist eines dieser Produkte für dich interessant oder suchst du nach anderen Optionen?
Ich mag den Damenpullover für meine Frau, aber ich suche einen Pullover für Jungen.
[Präsentiert Produkte]. Ist eines dieser Produkte für dich interessant oder suchst du nach anderen Optionen?
Leg den ersten Damenpullover in den Einkaufswagen.
Welche Größe möchtest du bei dem lässigen Damenpullover „Nineteen Solid Round Neck“? Wir haben Größen von XS bis XXL.
Medium
Perfekt! Der lässige Damenpullover „Nineteen Solid Round Neck“ in Größe M wurde mit der Menge 1 in deinen Einkaufswagen gelegt. Möchtest du noch etwas in den Einkaufswagen legen?
Nein
Der lässige Damenpullover „Nineteen Solid Round Neck“ kann frühestens am 29. April 2024 geliefert werden. Ist das in Ordnung?
Kann er am 28. April geliefert werden?
Leider können wir den lässigen Damenpullover „Nineteen Solid Round Neck“ nicht am 28. April 2024 liefern. Die frühestmögliche Lieferung ist am 29. April 2024.
Ok, dann bleibt es beim Liefertermin.
In Ordnung, dein lässiger Damenpullover „Nineteen Solid Round Neck“ wird am 29. April 2024 geliefert. Überprüfen wir jetzt deine Profildetails, damit alles auf dem neuesten Stand ist:
Lieferadresse: Musterstraße 15, 12345 Musterstadt
Zahlungsinformationen: Visa mit der Endung 4111
Telefonnummer: 0123 456789
E‑Mail-Adresse: email@example.com
Bitte überprüfe diese Angaben. Wenn alles korrekt ist, bestätige einfach. Wenn du Änderungen vornehmen möchtest, sag mir Bescheid.
Meine Adresse hat sich in Musterstraße 15, 12345 Musterstadt geändert.
Deine Lieferadresse wurde erfolgreich in Musterstraße 15, 12345 Musterstadt geändert. Möchtest du noch etwas ändern?
Nein
Deine Bestellung des lässigen Damenpullovers „Nineteen Solid Round Neck“ wurde mit der Bestell-ID ee6b4cc7 aufgegeben. Die Lieferung ist für den 29. April 2024 geplant.
Danke
Deine Bestellung wurde erfolgreich aufgegeben. Kann ich dir noch bei etwas helfen?
Nein danke
Schön, dass ich dir weiterhelfen konnte. Wenn du etwas von Cymbal Apparel brauchst, bin ich nur einen Klick entfernt.

Bestellstatus prüfen

Der Nutzer möchte den Status einer Bestellung prüfen. Der Agent erfasst die Bestellnummer und ruft die Bestellinformationen ab. Der Agent gibt Details zu den Artikeln in der Bestellung sowie den aktuellen Status und den voraussichtlichen Liefertermin an.

Nutzereingabe Antwort des KI-Agenten
Hallo
Wähle eine der Optionen oben aus oder gib einfach ein, wonach du suchst. Ich helfe dir dann weiter.
Ich möchte den Status meiner Bestellung prüfen.
Dabei kann ich dir gern helfen. Gib mir bitte deine Bestell-ID.
ee6b4cc7
Deine Bestellung wurde bestätigt. Sie wird gerade bearbeitet.
Das hast du bestellt:
Lässiger Damenpullover „Nineteen Solid Round Neck“
Größe: M
Menge: 1
Voraussichtliche Lieferung: 29. April 2024
Kann ich dir noch bei etwas helfen?
Nein danke
Schön, dass ich dir weiterhelfen konnte. Wenn du etwas von Cymbal Apparel brauchst, bin ich nur einen Klick entfernt.

Bestellung zurückgeben

Der Nutzer möchte eine Bestellung zurückgeben. Der Agent erfasst die Bestellnummer, ruft die Bestelldetails ab und bestätigt den zurückzugebenden Artikel. Der Agent leitet dann den Rückgabeprozess ein und stellt ein Rücksendelabel bereit, das der Nutzer ausdrucken und auf das Paket kleben kann.

Nutzereingabe Antwort des KI-Agenten
Hallo
Wähle eine der Optionen oben aus oder gib einfach ein, wonach du suchst. Ich helfe dir dann weiter.
Ich möchte meine Bestellung zurückgeben.
Ich helfe dir gern bei der Rückgabe. Gib mir bitte deine Bestellnummer.
0fc77d64
Vielen Dank für die Bestellnummer. Ich habe deine Bestellung vom 12. April 2024 gefunden. Die Bestellung enthält ein dunkelblaues T‑Shirt mit Rundhalsausschnitt und YK-Aufdruck für Jungen in Größe S. Ist das der Artikel, den du zurückgeben möchtest?
Ja
In Ordnung, ich habe den Rückgabeprozess eingeleitet. Das Rücksendelabel ist unten angehängt. Drucke es aus und klebe es auf das Paket, bevor du es zurücksendest. Kann ich dir noch bei etwas helfen?
Nein danke
Schön, dass ich dir weiterhelfen konnte. Wenn du etwas von Cymbal Apparel brauchst, bin ich nur einen Klick entfernt.

Grundlegende Einrichtung

So richtest du diesen vordefinierten Agenten ein:

  1. Importiere den vordefinierten Agenten.
  2. Konfiguriere die bereitgestellten Tools mit deinen externen Diensten. Weitere Informationen findest du unter Tool einrichten.

Tool einrichten

Dieser Agent enthält Tools, die für die Integration mit externen Diensten verwendet werden. So konfigurierst du diese Tools:

  1. Erstelle eine Firestore-Datenbank mit dem Namen apparel-db.
  2. Erstelle einen Firestore-Integrationsconnector.
  3. Lade die Application Integration für den Einkaufsassistenten herunter.
  4. Ersetze alle Verweise auf projects/customermod-genai-sa/locations/us-central1/connections/firestore durch die Kennung des in Schritt 2 erstellten Connectors.
  5. Lade die Integration hoch und veröffentliche sie.
  6. Weise deinem Dialogflow-Dienst-Agent die Rollen Cloud Functions Invoker zu.
  7. Folge der Anleitung, um deinen Retail-Katalog einzurichten.
  8. Aktualisiere die Attributsteuerungen , damit die folgenden Felder abgerufen werden können: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, uri.
  9. Importiere den Beispielkatalog in Zweig 1 deines Katalogs und lege ihn als Standardzweig fest.
  10. Lade die hier verfügbare Cloud Run-Funktion herunter und aktualisiere config.toml.
  11. Folge der Anleitung, um die Cloud Run-Funktion bereitzustellen.
  12. Weise der bereitgestellten Cloud Run-Funktion die IAM-Rolle Retail Viewer zu.
  13. Aktualisiere für die folgenden Tools: get-order-status, order-lookup, place-order und return-order, die Eigenschaft paths, um auf die in Schritt 5 erstellte Integration in den OpenAPI-Spezifikationen zu verweisen, und wähle die Dienstkontoauthentifizierung mit einem Dienstkonto aus, dem du die Rolle Application Integration Invoker zuweist.
  14. Aktualisiere die Server-URL-Eigenschaft für die übrigen Tools auf die bereitgestellte Cloud Run-Funktion.

Das Tool search-products ruft die am besten passenden Produkte basierend auf der Suchanfrage und dem Offsetwert aus dem Produktkatalog ab. Das Tool gibt eine benutzerdefinierte Nutzlastantwort mit Produktdetails zurück. Diese benutzerdefinierte Nutzlast wird von der UI verwendet, um die Produkte in Rich-Content-Form anzuzeigen.

Produktdetails

Das Tool get-product-details ruft Produktdetails aus dem Produktkatalog über die Retail API ab. Die abgerufenen Produktdetails werden dann transformiert und in einem vereinfachten Format zurückgegeben, das vom Agenten verwendet wird, um Fragen zu Produkten zu beantworten, die er dem Nutzer gezeigt hat.

Rezensionen

Das Tool get-reviews wird verwendet, um Rezensionen für Produkte abzurufen. Es erwartet eine Liste der angezeigten Produkte und ruft Rezensionen für jedes Produkt ab. Die generierten Rezensionen werden in ein benutzerdefiniertes Vorlagenformat (review_template) umgewandelt, das für die Anzeige in einer Rich-Benutzeroberfläche geeignet ist.

Ähnliche Produkte

Das Tool similar-products erleichtert die Suche nach Produkten, die einem bestimmten Produkt ähneln, mithilfe der Retail Recommendation API. Es akzeptiert eine Produkt-ID und verwendet die Retail Recommendation API, um ähnliche Produkte aus dem Produktkatalog vorherzusagen.

Lieferdatum

Das Tool store-delivery-date speichert das bevorzugte Lieferdatum des Nutzers für Artikel im Einkaufswagen, das mit dem frühesten voraussichtlichen Lieferdatum verglichen werden sollte.

Das Tool get-delivery-date schätzt den Liefertermin für Artikel im Einkaufswagen.

Nutzerdaten

Das Tool get-user-info ruft die personenbezogenen Daten des Nutzers ab, einschließlich Versandadresse, Zahlungsinformationen, Telefonnummer und E‑Mail-Adresse. Das Tool `update-user-info` aktualisiert die Nutzerinformationen.

Bestellverwaltung

Das Tool place-order verarbeitet die Bestellung der Artikel im Einkaufswagen. Es speichert die Bestellung in Firestore mit den Bestelldaten, einschließlich Bestell-ID, Status, Erstellungszeitstempel und Liste der Produkte. Es gibt die Bestellnummer an den Agenten zurück.

Das Tool order-lookup ruft Bestelldaten aus einer Firestore-Datenbank basierend auf der angegebenen Bestell-ID ab.

Das Tool return-order aktualisiert den Status einer Bestellung in der Firestore-Datenbank auf „return_pending“. Dies zeigt an, dass die Rückgabe vom Kunden eingeleitet wurde und die Bestellung zur Rückgabe ansteht.

Das Tool get-order-status ruft den Status einer Bestellung ab und verfolgt sie, falls sie versandt wurde, über die DHL API. Es gibt je nach Status der Bestellung entsprechende Nachrichten aus.

Abgeschlossen

Dein Agent und seine Integrationen sollten jetzt eingerichtet und bereit für Tests sein.