Vordefinierter KI-Agent „Shopping Assistant“

Der Playbook-basierte, vordefinierte Agent „Shopping Assistant“ bietet Produktabfragen, Bestellungen, Bestellstatus und Bestellstornierungen für den Einzelhandel. Es verwendet die Agentensuche für den Einzelhandel und benutzerdefinierte Nutzlasten für die Auftragsausführung, um eine umfassende visuelle Darstellung zu bieten.

Beispieldialog

In diesem Beispieldialog werden häufige Szenarien gezeigt, die von diesem vordefinierten Agenten verarbeitet werden.

Produkt- und Rezensionsvergleich

1. Der Nutzer möchte sich traditionelle Saris ansehen.
2. Der KI-Agent präsentiert einige beliebte Optionen und der Nutzer wählt die erste aus.
3. Der Nutzer fragt nach passenden Schuhen.
4. Der Agent präsentiert einige beliebte Optionen und der Nutzer bittet darum, die Rezensionen zu vergleichen, und wählt die am besten bewertete Option aus.
5. Der KI-Agent fragt nach der Größe und bestätigt, dass die Schuhe dem Einkaufswagen hinzugefügt wurden.

Nutzereingabe	Antwort des KI-Agenten
Zeig mir traditionelle Saris
	[Präsentiert Produkte] Interessieren Sie sich für eines dieser Produkte oder suchen Sie nach anderen Optionen?
Das erste sieht gut aus
	Das ist eine gute Wahl. Der indische Sari „Self Design, Printed Fashion Georgette“ ist ein wunderschönes Kleidungsstück. Da Saris in der Regel eine Einheitsgröße haben, wird er perfekt passen. Möchtest du ihn in den Einkaufswagen legen?
Hast du passende High Heels dazu?
	[Präsentiert Produkte] Interessieren Sie sich für eines dieser Produkte oder suchen Sie nach anderen Optionen?
yes but can you go through the customer review and pick the best one from these
	Die Flat n Heels Damen-Heels haben eine durchschnittliche Bewertung von 4 von 5 Sternen, während die Glitzy Galz Damen-Heels eine durchschnittliche Bewertung von 4,5 von 5 Sternen haben. Kunden, die die Flat n Heels Women Heels gekauft haben, hatten gemischte Bewertungen. Einige fanden sie anfangs bequem, aber nach ein paar Stunden unbequem, während andere ihren Komfort lobten. Die Glitzy Galz Women Heels hingegen erhielten überwiegend positive Rezensionen, in denen die Passform, die Qualität und das Design gelobt wurden. Welches Produkt möchtest du in den Einkaufswagen legen?
das mit den besten Rezensionen und Bewertungen
	Die Glitzy Galz Damen-High-Heels haben die höchste Bewertung mit 4,5 von 5 Sternen. Welche Größe möchten Sie für die Glitzy Galz Women Heels? Wir haben die Größen 5 bis 11.
6
	Perfekt! Die Glitzy Galz-Damenschuhe mit Absatz in Größe 39 wurden Ihrem Einkaufswagen hinzugefügt (Anzahl: 1). Möchten Sie Ihrem Einkaufswagen noch etwas hinzufügen?

End-to-End-Shoppingerlebnis

1. Der Nutzer sucht im Produktkatalog.
2. Der Agent präsentiert Empfehlungen basierend auf der Anfrage des Nutzers.
3. Nach einigen Suchanfragen findet der Nutzer einen Artikel, den er kaufen möchte.
4. Der Agent bestätigt die Größe und Menge des zu kaufenden Artikels sowie das voraussichtliche Lieferdatum.
5. Der Nutzer bittet um ein anderes Lieferdatum, das nicht verfügbar ist, und stimmt dem ursprünglichen Lieferdatum zu.
6. Der Kundenservicemitarbeiter bestätigt die hinterlegten Liefer-, Zahlungs- und Kontaktdaten.
7. Der Nutzer aktualisiert die Lieferinformationen und bestätigt sie.
8. Der Agent gibt die Bestellung auf und teilt dem Nutzer die Bestellnummer mit.

Nutzereingabe	Antwort des KI-Agenten
Es wird kalt. Hast du gute Pullover?
	[Präsentiert Produkte]. Interessiert dich eines dieser Produkte oder suchst du nach anderen Optionen?
Der Damenpullover gefällt mir für meine Frau, aber ich suche einen Pullover für Jungen.
	[Präsentiert Produkte]. Interessiert dich eines dieser Produkte oder suchst du nach anderen Optionen?
den ersten Damenpullover in den Einkaufswagen legen
	Welche Größe möchten Sie für den Nineteen Solid Round Neck Casual Women's Sweater? Wir haben Größen von XS bis XL.
mittel
	Perfekt! Der Nineteen Solid Round Neck Casual Damenpullover in Größe M wurde Ihrem Einkaufswagen hinzugefügt (Anzahl: 1). Möchten Sie Ihrem Einkaufswagen noch etwas hinzufügen?
no
	Der frühestmögliche Liefertermin für den Nineteen Solid Round Neck Casual Women's Sweater ist der 29. April 2024. Wären Sie daran interessiert?
Können Sie es am 28. April liefern?
	Leider können wir den Nineteen Solid Round Neck Casual Women's Sweater nicht am 28. April 2024 liefern. Der frühestmögliche Liefertermin ist der 29. April 2024.
Ok, behalte das Lieferdatum bei.
	Alles klar, dein Nineteen Solid Round Neck Casual Women's Sweater wird am 29. April 2024 geliefert. Überprüfen Sie jetzt Ihre Profildetails, um sicherzustellen, dass alles auf dem neuesten Stand ist:\
Delivery Address: 638 Maple Street, Apt 11, Cupertino, CA 95014\
	Zahlungsinformationen: Visa-Karte mit den Endziffern 4111 Kontaktnummer: 416-555-5555 E-Mail-Adresse: [e-mail] Bitte überprüfe diese Angaben. Wenn alles korrekt ist, bestätigen Sie einfach. Wenn Sie Änderungen vornehmen möchten, geben Sie mir Bescheid.
Meine Adresse hat sich geändert: 371 Talbot Street, Carmichael, CA 95608, USA
	Ihre Lieferadresse wurde aktualisiert: 371 Talbot Street, Carmichael, CA 95608. Möchten Sie noch etwas ändern?
no
	Ihre Bestellung für den Nineteen Solid Round Neck Casual Women's Sweater wurde mit der Bestell-ID ee6b4cc7 aufgegeben. Die Lieferung ist für den 29. April 2024 geplant.
Danke
	Deine Bestellung wurde aufgegeben. Kann ich Ihnen noch bei weiteren Fragen helfen?
Nein danke
	Schön, dass ich Ihnen weiterhelfen konnte. Wenn Sie etwas von Cymbal Apparel benötigen, bin ich nur einen Klick entfernt.\

Bestellstatus prüfen

1. Der Nutzer möchte den Status einer Bestellung prüfen.
2. Der Agent erfasst die Bestellnummer und ruft die Bestellinformationen ab.
3. Der Agent stellt Details zu den Artikeln in der Bestellung und dem voraussichtlichen Liefertermin bereit.

Nutzereingabe	Antwort des KI-Agenten
Hallo
	Wählen Sie einfach eine der Optionen oben aus oder geben Sie ein, wonach Sie suchen, und ich helfe Ihnen weiter.
Ich möchte den Status meiner Bestellung überprüfen.
	Dabei kann ich Ihnen gern helfen. Können Sie mir bitte zuerst Ihre Bestell-ID nennen?
ee6b4cc7
	Deine Bestellung wurde bestätigt. Sie wird gerade bearbeitet. Das haben Sie bestellt: Nineteen Solid Round Neck Casual Women's Sweater Größe: Medium Anzahl: 1 Voraussichtliche Lieferung: 29. April 2024 Kann ich Ihnen sonst noch helfen?
Nein danke
	Schön, dass ich Ihnen weiterhelfen konnte. Wenn Sie etwas von Cymbal Apparel benötigen, bin ich nur einen Klick entfernt.

Bestellung zurückgeben

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

Nutzereingabe	Antwort des KI-Agenten
Hallo
	Wählen Sie einfach eine der Optionen oben aus oder geben Sie ein, wonach Sie suchen, und ich helfe Ihnen weiter.
Ich möchte meine Bestellung zurückgeben.
	Ich helfe dir gern bei der Rückgabe. Könntest du mir bitte zuerst deine Bestellnummer nennen?
0fc77d64
	Vielen Dank, dass du deine Bestellnummer angegeben hast. Ich habe Ihre Bestellung vom 12. April 2024 gefunden. Die Bestellung enthält ein dunkelblaues T-Shirt mit Rundhalsausschnitt für Jungen von YK in Größe S. Ist das der Artikel, den Sie zurückgeben möchten?
Ja
	Ich habe den Rückgabeprozess gestartet. Das Rücksendelabel findest du im Anhang. Bitte drucke es aus und bringe es am Paket an, bevor du es zurücksendest. Kann ich Ihnen noch bei weiteren Fragen helfen?
Nein danke
	Schön, dass ich Ihnen weiterhelfen konnte. Wenn Sie etwas von Cymbal Apparel benötigen, bin ich nur einen Klick entfernt.

Grundlegende Einrichtung

So richten Sie diesen vordefinierten Agenten ein:

1. Vordefinierten Agent importieren
2. Konfigurieren Sie die bereitgestellten Tools mit Ihren externen Diensten. Weitere Informationen finden Sie unter Tool einrichten.

Tool einrichten

Dieser Agent enthält Tools, die für die Einbindung externer Dienste verwendet werden. So konfigurieren Sie diese Tools:

1. Erstellen Sie eine Firestore-Datenbank mit dem Namen apparel-db.
2. Erstellen Sie einen Firestore-Integrations-Connector.
3. Laden Sie die Application Integration für den Einkaufsassistenten herunter.
4. Ersetzen Sie alle Verweise auf projects/customermod-genai-sa/locations/us-central1/connections/firestore durch die Kennung des in Schritt 2 erstellten Connectors.
5. Laden Sie die Integration hoch und veröffentlichen Sie sie.
6. Weisen Sie Ihrem Dialogflow-Dienst-Agent die Rolle Cloud Functions Invoker zu.
7. Folgen Sie der Anleitung zum Einrichten Ihres Einzelhandelskatalogs.
8. Aktualisieren Sie die Attributsteuerelemente, 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. Importieren Sie den Beispielkatalog in Zweig 1 Ihres Katalogs und legen Sie ihn als Standardzweig fest.
10. Laden Sie die Cloud Run-Funktion herunter und aktualisieren Sie config.toml.
11. Folgen Sie der Anleitung zum Bereitstellen der Cloud Run-Funktion.
12. Weisen Sie der bereitgestellten Cloud Run-Funktion die IAM-Rolle Retail Viewer zu.
13. Aktualisieren Sie für die folgenden Tools: get-order-status, order-lookup, place-order und return-order das Attribut paths, um auf die Integration zu verweisen, die Sie in Schritt 5 in den OpenAPI-Spezifikationen erstellt haben, und wählen Sie Dienstkonto-Authentifizierung mit einem Dienstkonto aus, dem Sie die Rolle Application Integration Invoker zuweisen.
14. Aktualisieren Sie das Attribut für die Server-URL auf die Cloud Run-Funktion, die Sie für die verbleibenden Tools bereitgestellt haben.

Tool „Produkte suchen“

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

Tool „Produktdetails abrufen“

Das Tool get-product-details ruft Produktdetails aus dem Produktkatalog mithilfe der AI Commerce Search API ab. Das System transformiert die abgerufenen Produktdetails und gibt sie in einem vereinfachten Format zurück. Der Agent verwendet diese Informationen, um Fragen zu den Produkten zu beantworten, die er dem Nutzer gezeigt hat.

Tool „Rezensionen erhalten“

Das Tool get-reviews ruft Rezensionen für Produkte ab. 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 sich für die Anzeige in einer Rich-Benutzeroberfläche eignet.

Tool „Ähnliche Produkte“

Mit dem Tool similar-products können Sie mithilfe der Retail Recommendation API Produkte finden, die einem bestimmten Produkt ähneln. Sie akzeptiert eine Produkt-ID und verwendet die Retail Recommendation API, um ähnliche Produkte aus dem Produktkatalog vorherzusagen.

Tools für das Lieferdatum

Das Tool store-delivery-date ist dafür verantwortlich, das bevorzugte Lieferdatum des Nutzers für Artikel im Einkaufswagen zu speichern, das mit dem frühesten geschätzten Lieferdatum verglichen werden soll.

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

Tool „Nutzerinformationen abrufen“

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 Informationen des Nutzers.

Tool „Bestellung aufgeben“

Das Tool place-order gibt eine Bestellung für Artikel im Einkaufswagen auf. Die Bestelldaten werden in Firestore gespeichert, einschließlich Bestell-ID, Status, Erstellungszeitstempel und Produktliste. Anschließend wird die Bestellnummer an den Agenten zurückgegeben.

Bestellsuche

Das Tool order-lookup ruft Bestelldaten aus einer Firestore-Datenbank mithilfe der angegebenen Bestell-ID ab und gibt die Bestellinformationen an den Agenten zurück.

Tool „Bestellung zurückgeben“

Das Tool return-order aktualisiert den Status einer Bestellung in der Firestore-Datenbank auf „return_pending“. Das bedeutet, dass eine Rückgabe eingeleitet wurde und aussteht.

Tool „Bestellstatus abrufen“

Das Tool get-order-status ruft den Status einer Bestellung ab und verfolgt sie, wenn sie versendet wird, über die DHL API. Sie stellt je nach Bestellstatus die entsprechenden Nachrichten bereit.

Abgeschlossen

Ihr Agent und seine Integrationen sollten jetzt eingerichtet und bereit zum Testen sein.