Moduleinstellungen¶

Sobald Ihr Produkt-Feed verbunden und synchronisiert ist, besteht der nächste Schritt darin, die Product-Recommender-Agenten zu konfigurieren.
Jeder Agent ist auf einen anderen Teil des Gesprächs spezialisiert – vom Erkennen der Absicht des Kunden bis zum Empfehlen, Vergleichen oder Hinzufügen von Produkten zum Warenkorb.

Diese Agenten arbeiten zusammen, um ein nahtloses, KI-gestütztes Einkaufserlebnis zu schaffen.

Info

Die meisten Agenten sollten auch ohne jeglichen Prompt von Haus aus funktionieren. Verwenden Sie ihn nur zur Feinabstimmung, um Ihre Geschäftslogik abzubilden, nachdem Sie es zunächst ohne ihn getestet haben.

Prompt-Einstellungen der Agenten¶

Überblick über die verfügbaren Agenten und ihre typischen Konfigurationsoptionen.

1️⃣ Triage-Agent¶

Zweck:

Fungiert als „Verkehrslotse" für Nutzeranfragen.
Er analysiert die Nachricht des Kunden und entscheidet, welcher Agent den nächsten Schritt übernehmen soll.

Beispiele für Routing-Regeln:

Allgemeine Kategoriefragen und Hilfe bei der Produktauswahl → Advisor-Agent
Suche nach bestimmten Produkten mit ≥ 3 Attributen → Search-Agent
Fragen zu Produktinformationen/-spezifikationen → QnA-Agent
Produkte vergleichen → Compare-Agent
Artikel zum Warenkorb hinzufügen → Add-to-Cart-Agent
Themenfremde Fragen → Offtopic-Agent

Prompt-Beispiele (Triage Agent Instructions):
Definieren Sie eine benutzerdefinierte Logik für Routing-Regeln:

„Wenn der Nutzer nach Handyhüllen fragt, überspringe den Advisor und gehe direkt zur Suche."

„Verwende niemals das Such-Modul."

„Verwende nicht den Advisor; verwende nur das Such-Modul."

2️⃣ Advisor-Agent¶

Zweck:

Führt Nutzer, indem er einige Fragen stellt (er ermittelt bis zu 3 Schlüsselparameter), um die Produktauswahl einzugrenzen und bestimmte Produkte zu finden.

Analysiert Kategorien und deren Parameter.
Nutzt die Kaufhistorie zur Personalisierung.

Workflow-Logik:

Kategorien identifizieren
Parameter laden
Schlüsselparameter auswählen
Fragen stellen
Suchanfrage erstellen
Ergebnisse interpretieren
An spezialisierten Agenten übergeben (Compare, Add-to-Cart, QnA, Offtopic)
Die Ausgabe ist spezifisch für den verwendeten Kanal:
Chat → Ein Produktkarussell darstellen
Voice → Produkte und ihre Schlüsselattribute vorlesen

Prompt-Beispiele (Advisor Agent Instructions):

„Frage in der Kategorie Sport → Schuhe immer nach der Schuhgröße."

„Wenn der Nutzer nach einem Fernseher fragt, bestätige immer die Bildschirmgröße und die Marke."

„Ignoriere die Produktattribute x und y."

3️⃣ Search-Agent¶

Zweck:

Wenn der Nutzer bereits genügend Informationen bereitstellt (in der ersten Nachricht oder nach der Interaktion mit anderen Agenten), findet dieser Agent direkt Produkte → keine klärenden Fragen.

Analysiert die Eingaben, um die relevantesten Kategorien zu erkennen.
Ordnet die Anforderungen des Nutzers den verfügbaren Produktparametern zu.
Erstellt die Suchanfrage.
Nutzt die Kaufhistorie, um die Absicht besser zu interpretieren.

Workflow-Logik:

Kategorien identifizieren
Parameter laden
Anfrage den Parametern zuordnen
Suchanfrage erstellen
An den nächsten Agenten übergeben
Die Ausgabe ist eine Reihe von Produkten, die im Hinblick auf Instructions for Search Result Summarization zusammengefasst werden. Die Ausgabe ist außerdem spezifisch für den verwendeten Kanal:
Chat → Ein Produktkarussell darstellen
Voice → Produkte und ihre Schlüsselattribute vorlesen

Prompt-Beispiele (Search Agent Instructions):

„Ignoriere Ergebnisse unter 5 €."

„Sortiere immer zuerst nach den beliebtesten."

„Priorisiere bei elektronischen Geräten den Abgleich der Marke."

„Beziehe bei Schuhanfragen immer Sport → Schuhe ein."

4️⃣ QnA-Agent¶

Zweck:

Bearbeitet detaillierte Nutzerfragen zu einem bestimmten Produkt (auf Basis der verfügbaren Produktinformationen).

Identifiziert das Produkt anhand von URL, Name oder ID.
Lädt detaillierte Produktinformationen aus der Datenbank.
Liefert präzise Antworten auf Basis der Produktdaten.
Leitet komplexe Fragen an den passenden Agenten weiter.

Workflow:

Das Produkt in der Anfrage identifizieren
Produktinformationen abrufen
Die Antwort in den Daten finden
Dem Kunden antworten
Anschlussfragen bei Bedarf weiterleiten

Prompt-Beispiele (QnA Agent Instructions):

„Füge bei jeder Antwort immer den Produktlink hinzu."

„Wenn die Daten des Produkts die Antwort nicht enthalten, entschuldige dich und biete an, mit dem Support zu verbinden."

„Wenn nach der Installation von Produkt X gefragt wird, bitte den Nutzer, eine E-Mail an support@example.com zu senden, und unser Techniker wird helfen."

„Wenn der Kunde das Wort X verwendet, suche nach Z, weil X Slang ist, der in unserem Katalog nicht verwendet wird."

5️⃣ Compare-Agent¶

Zweck:

Hilft Nutzern bei der Entscheidung zwischen zwei oder mehr Produkten. Versucht, klare Produktvergleiche mit Schwerpunkt auf Schlüsselmerkmalen, Unterschieden und Gemeinsamkeiten zu liefern.

Gibt einen Vergleich von mindestens zwei Produkten zurück oder eskaliert an einen Operator.
Wenn kein letztes Suchergebnis verfügbar ist, fordert er Produkt-URLs vom Kunden an.

Prompt-Beispiele (Compare Agent Instructions):

„Hebe praktische Unterschiede wie Akkulaufzeit oder Größe hervor."

„Priorisiere bei Matratzen den Vergleich der Belastbarkeit."

„Ignoriere Attribute, die bei allen Produkten identisch sind."

„Übergib beim Vergleich von Produkten mit einem Preis über 2.000 € an einen Operator."

„Versuche, die teurere Option per Upselling zu verkaufen."

6️⃣ Add-to-Cart-Agent¶

Zweck:

Fügt ausgewählte Artikel dem Warenkorb des Nutzers hinzu. Kann die Menge bestätigen oder Zubehör anbieten.

Eine Liste der zum Warenkorb hinzuzufügenden Artikel wird in $context als Array von Objekten gespeichert: { item_id, amount }.

Prompt-Beispiele (Add to Cart Agent Instructions):

„Wenn der Nutzer mehr als 5 Artikel hinzufügt, bitte um Bestätigung."

„Schlage kompatibles Zubehör vor, wenn hochwertige Artikel hinzugefügt werden."

„Wenn der Warenkorbwert mehr als 1000 € beträgt, übergib an einen Operator."

7️⃣ Offtopic-Agent¶

Zweck: Bearbeitet themenfremde Fragen höflich und lenkt zum Einkaufskontext zurück (oder eskaliert an einen Operator oder kehrt zum Triage-Agenten zurück).

Prompt-Beispiele (Offtopic Agent Instructions):

„Wenn nach dem Wetter gefragt wird, schlage passende saisonale Produkte vor."

„Wenn die Frage nichts mit dem Einkaufen zu tun hat, antworte nicht und biete Unterstützung bei Produkten an."

„Bei Beschwerden über Wettbewerber hebe höflich unsere Vorteile hervor."

„Wenn nach X gefragt wird, eskaliere an einen Operator."

Allgemeine Einstellungen¶

Allgemeine Einstellungen ändern das Verhalten über alle Agenten hinweg.

Index-Name¶

Wählt aus, welcher Suchindex verwendet werden soll

Artikeltypen¶

Legt den Typ Ihrer Produkte fest. Diese Einstellung beeinflusst, wie sich alle Agenten verhalten
und welche Terminologie sie verwenden.
Derzeit werden „Produkte" für physische Waren oder „Reisen" für Reisedienstleistungen unterstützt.

Allgemeine Anweisungen¶

Übergeordnete Richtlinien für das gesamte System
Beispiel: „Du bist ein Agent, der dem Online-Shop X hilft, der Laufausrüstung verkauft. Deine Persona ist männlich, kommuniziere informell, aber höflich."

Kaufhistorie (beeinflusst die Agenten Advisor, Search, QnA)¶

Kaufhistorie des Kunden → Personalisierungseingabe für bessere Empfehlungen

💡 Beispiel für einen End-to-End-Ablauf¶

Kunde: „Ich brauche einen leichten Laptop für die Fotobearbeitung unter 1500 €."
Der Triage-Agent wählt den Advisor-Agenten zur Fortsetzung: Der Advisor-Agent fragt nach Bildschirmgröße, RAM/SSD, bevorzugter Marke (max. 3 Schlüsselparameter).
Der Advisor-Agent erstellt die Anfrage und übergibt an den Search-Agenten, um Kandidaten abzurufen.
Der Product-Reply-Agent fasst die Ergebnisse zusammen; im Chat wird ein Karussell angezeigt, per Voice werden die Highlights vorgelesen.
Kunde: „Was ist der Unterschied zwischen den ersten beiden?"
Der Compare-Agent liefert klare Unterschiede und praktische Abwägungen.
Kunde: „Füge den zweiten meinem Warenkorb hinzu, 2 Stück."
Der Add-to-Cart-Agent speichert [ { item_id: "...", amount: 2 } ] im Kontextwert und schlägt optional kompatibles Zubehör vor.