Vordefinierter Shopping Assistant-Agent mit Vertex AI Search for Retail

Der auf einem Playbook basierende vordefinierte Agent für den Einkaufsassistenten bietet 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 37 wurden mit der Menge 1 in den 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 fordert einen anderen Liefertermin an, der nicht verfügbar ist, und stimmt dem ursprünglichen Liefertermin 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 den 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. Wären Sie damit einverstanden?
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, der lässige Damenpullover „Nineteen Solid Round Neck“ wird am 29. April 2024 geliefert. Sehen wir uns jetzt deine Profildetails an, um sicherzustellen, dass alles auf dem neuesten Stand ist:
Lieferadresse: Musterstraße 15, 12345 Berlin
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 geändert: Musterstraße 15, 12345 Berlin
Deine Lieferadresse wurde erfolgreich in Musterstraße 15, 12345 Berlin 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 weiteren Fragen 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.
Du hast Folgendes bestellt:
Lässiger Damenpullover „Nineteen Solid Round Neck“
Größe: M
Menge: 1
Voraussichtliche Lieferung: 29. April 2024
Kann ich dir noch bei weiteren Fragen 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 weiteren Fragen 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 Cloud Run-Funktion herunter, die hier verfügbar ist, 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` ist für die Aktualisierung der Nutzerdaten zuständig.

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 zum Testen sein.