Products

Was sind Produkte?

Produkte bilden den Katalog, aus dem dein KI-Agent schöpft, wenn er Besuchern hilft. Jedes Produkt, das du anlegst — mit Name, Beschreibung, Attributen und Varianten — wird zu Wissen, das der Agent durchsuchen, empfehlen und im Gespräch darstellen kann.

Stell dir vor, du baust eine strukturierte Produktdatenbank, die direkt in deinem Agenten lebt. Wenn ein Besucher fragt „Gibt es das auch in Blau?" oder „Aus welchem Material ist die Jacke?", schlägt der Agent die Antwort in deinem Produktkatalog nach.

Produkte gehören zu einem Agenten. Jeder Agent hat seinen eigenen Katalog, sodass du über verschiedene Agenten vollständig unterschiedliche Produktlinien betreiben kannst.

Produkt erstellen

Öffne Produkte in der linken Seitenleiste. Klicke rechts oben auf Neues Produkt.

Du wirst nach einem Namen gefragt. Nach der Bestätigung wird das Produkt angelegt und du landest direkt auf der Detailseite, wo du alles weitere hinzufügen kannst.

Name

Der Produktname ist das, was der KI-Agent im Gespräch verwendet, wenn er sich auf dieses Produkt bezieht. Halte ihn klar und aussagekräftig — genau wie du ihn in einem Shop oder Katalog benennen würdest.

Beispiel: Merino-Woll-Rundhalsshirt oder Running Shoe Pro 3.0

Beschreibung

Die Beschreibung gibt dem Agenten Kontext über das Produkt, der über den Namen hinausgeht. Schreib sie so, als würdest du einem Kunden das Produkt als Verkaufsberater erklären — was es ist, wofür es gedacht ist und was es besonders macht.

Beispiel: Leichtes Merino-Woll-Rundhalsshirt, natürlich temperaturregulierend. Ideal zum Layern im Herbst und Winter. Maschinenwaschbar bei 30 °C.

Handle

Das Handle ist ein URL-freundlicher Bezeichner, der automatisch aus dem Produktnamen generiert wird. Es wird intern zur Referenzierung des Produkts verwendet. Du kannst es bei Bedarf manuell anpassen — es muss jedoch innerhalb deines Agenten eindeutig sein.

Beispiel: Wenn der Name Running Shoe Pro 3.0 lautet, könnte das Handle running-shoe-pro-3-0 sein.

Attribute hinzufügen

Attribute beschreiben dein Produkt auf strukturierte Weise. Stell sie dir als Schlüssel-Wert-Paare vor, die der Agent lesen und kommunizieren kann: Preis: 89,99, Material: Bio-Baumwolle, Herkunft: Portugal.

Öffne die Detailseite des Produkts und wechsle zum Abschnitt Attribute. Klicke auf Attribut hinzufügen, um ein neues anzulegen.

Attributtypen

Jedes Attribut hat einen Typ, der bestimmt, welche Art von Wert es enthält:

| Typ | Verwenden für | |-----|---------------| | Text | Kurze Labels, Materialien, Kategorien, Herkunftsländer | | Zahl | Preise, Gewichte, Abmessungen | | Bild | Produktfotos, verknüpft mit einem Datenelement | | Daten | Verknüpfte Dateien oder Dokumente aus deiner Datenbibliothek |

Attributfelder

| Feld | Beschreibung | |------|--------------| | Typ | Die Art des Werts (siehe oben) | | Verwendung | Wie der Agent dieses Attribut nutzen soll — informativ, filterbar oder nur zur Anzeige | | Wert | Der eigentliche Inhalt des Attributs (Text, Zahl oder Verweis auf ein Datenelement) | | Bild-URL | Für Bildattribute: die URL des anzuzeigenden Bildes | | Verknüpftes Datenelement | Für Daten- oder Bildattribute: ein Verweis auf eine Datei in deiner Datenbibliothek |

Attribute sind flexibel — ein einzelnes Produkt kann so viele Attribute haben, wie es braucht. Ein einfaches Produkt kommt vielleicht mit Preis und Material aus. Ein technisches Detailprodukt kann ein Dutzend Attribute haben, die Abmessungen, Zertifizierungen, Kompatibilität und mehr abdecken.

Variantentypen definieren

Variantentypen sind Vorlagen, die festlegen, entlang welcher Dimensionen deine Produkte variieren. Beispiele: Farbe, Größe, Passform, Material.

Variantentypen werden auf Agentenebene definiert, nicht pro Produkt. Das bedeutet, dieselben Variantentypen gelten für den gesamten Produktkatalog dieses Agenten.

Öffne Produkte und wechsle zu Variantentypen (in der Regel als Tab oder Abschnitt am Anfang des Produktbereichs). Klicke auf Neuer Variantentyp, um einen anzulegen.

Felder für Variantentypen

| Feld | Beschreibung | |------|--------------| | Name | Der Name der Dimension, z. B. Farbe, Größe, Weite |

Sobald du einen Variantentyp angelegt hast, steht er für alle Produkte dieses Agenten zur Verfügung. Die konkreten Werte vergibst du dann beim Erstellen von Varianten auf den einzelnen Produkten (siehe unten).

Beispiel: Farbe und Größe einrichten

Wenn du Kleidung verkaufst, würdest du typischerweise zwei Variantentypen anlegen:

• Farbe — Werte wie Schwarz, Weiß, Marineblau
• Größe — Werte wie XS, S, M, L, XL

Diese Typdefinitionen existieren einmalig auf Agentenebene. Jedes Produkt wählt dann die konkreten Kombinationen, die es anbietet (siehe unten).

Varianten erstellen

Varianten sind die spezifischen, käuflichen Ausführungen eines Produkts. Jede Variante ist eine Kombination aus Werten deiner Variantentypen.

Öffne die Detailseite des Produkts und wechsle zum Abschnitt Varianten. Klicke auf Neue Variante, um eine anzulegen.

Wie Varianten funktionieren

Eine Variante wird aus einer Menge von Typ-Wert-Paaren zusammengestellt. Für jeden Variantentyp, den du definiert hast, wählst du einen Wert. Die Kombination dieser Werte ergibt die Variante.

Beispiel: Für ein Produkt mit den Variantentypen Farbe und Größe:

| Variante | Farbe | Größe | |----------|-------|-------| | Variante 1 | Schwarz | S | | Variante 2 | Schwarz | M | | Variante 3 | Marineblau | M | | Variante 4 | Marineblau | L |

Jede Variante kann auch eigene Attributwerte tragen — zum Beispiel einen anderen Preis oder ein bestimmtes Bild — und damit die auf Produktebene gesetzten Standardwerte überschreiben.

Werte zu einem Variantentyp hinzufügen

Beim Erstellen einer Variante wählst du Werte für jeden Variantentyp. Wenn ein Wert noch nicht existiert (z. B. Waldgrün für Farbe), kannst du ihn direkt im Erstellungsdialog hinzufügen.

Neu hinzugefügte Werte werden für diesen Variantentyp gespeichert und stehen bei zukünftigen Varianten aller Produkte des Agenten zur Verfügung.

Produkte mit Tools und Plugins verknüpfen

Produkte erscheinen nicht automatisch in jedem Gespräch. Sie werden über Produkt-Links verfügbar gemacht — Verbindungen zwischen einem Produkt und einem bestimmten Tool oder Plugin.

Wenn du ein Produkt mit einem Tool verknüpfst, kann der Agent es einsetzen, wenn dieses Tool ausgeführt wird. Wenn du zum Beispiel ein Tool Produktberater hast, werden im Gespräch nur die damit verknüpften Produkte verwendet.

Öffne die Detailseite des Produkts und wechsle zum Abschnitt Links, um zu verwalten, welche Tools und Plugins Zugriff auf dieses Produkt haben.

Dieses System gibt dir präzise Kontrolle: Ein Produkt kann für manche Agentenfähigkeiten relevant sein und für andere nicht. Ein Lieferantenartikel im Hintergrund könnte nur mit einem internen Lookup-Tool verknüpft sein, während Kundenprodukte mit den Empfehlungs- und Anzeigetools verbunden sind.

Einstellungen im Überblick

Produkt

| Einstellung | Beschreibung | |-------------|--------------| | Name | Anzeigename, den die KI im Gespräch verwendet | | Beschreibung | Kontext und Details zum Produkt | | Handle | URL-Slug, automatisch generiert, muss innerhalb des Agenten eindeutig sein |

Attribute

| Einstellung | Beschreibung | |-------------|--------------| | Typ | Werttyp: Text, Zahl, Bild oder Daten | | Verwendung | Wie das Attribut vom Agenten genutzt wird | | Wert | Der Inhalt des Attributs | | Bild-URL | Direkte URL für Bildattribute | | Verknüpftes Datenelement | Verweis auf eine Datei in der Datenbibliothek |

Variantentypen

| Einstellung | Beschreibung | |-------------|--------------| | Name | Der Dimensionsname (z. B. Farbe, Größe) — auf Agentenebene definiert |

Varianten

| Einstellung | Beschreibung | |-------------|--------------| | Typwerte | Die Wertkombination, die diese Variante definiert |

Produkte verwalten

Suchen und Filtern

Die Produktliste zeigt alle Produkte des aktuellen Agenten. Mit dem Suchfeld oben kannst du nach Name filtern. Das ist praktisch, wenn dein Katalog größer wird.

Die Liste ist paginiert — nutze die Navigation am unteren Ende der Liste, um zwischen Seiten zu blättern.

Produkt bearbeiten

Klicke in der Liste auf ein Produkt, um die Detailseite zu öffnen. Dort kannst du:

• Namen und Beschreibung ändern
• Attribute hinzufügen, bearbeiten oder entfernen
• Neue Varianten erstellen oder bestehende aktualisieren
• Produktlinks verwalten

Speichere Änderungen mit dem Speichern-Button. Updates werden vom Agenten sofort übernommen.

Produkt löschen

Öffne die Detailseite des Produkts und nutze die Lösch-Option am unteren Ende der Seite.

Das Löschen eines Produkts entfernt es dauerhaft aus dem Katalog. Der Agent kann es danach weder finden noch empfehlen. Varianten und Attribute werden dabei ebenfalls entfernt.

Das Löschen ist endgültig. Wenn du ein Produkt versehentlich löschst, musst du es von Grund auf neu anlegen.

Variantentyp löschen

Das Löschen eines Variantentyps entfernt ihn aus allen Produkten des Agenten. Varianten, die Werte dieses Typs verwendet haben, verlieren diese Zuordnung. Überleg gut, bevor du einen Variantentyp löschst, der aktiv in vielen Produkten genutzt wird.

Häufige Fragen

Kann ich Produkte in großer Stückzahl importieren? Noch nicht. Produkte werden aktuell einzeln im Dashboard angelegt. Ein Massenimport ist in Planung.

Was passiert, wenn ich einen Variantentyp lösche? Der Variantentyp und alle seine definierten Werte werden entfernt. Varianten, die Werte dieses Typs referenziert haben, werden aktualisiert und verlieren diese Zuordnung. Die Varianten selbst werden nicht gelöscht — sie verlieren lediglich die betreffende Dimension.

Können zwei Produkte dasselbe Handle haben? Nein. Handles müssen innerhalb eines Agenten eindeutig sein. Wenn du versuchst, ein doppeltes Handle zu speichern, wirst du im Dashboard aufgefordert, ein anderes zu wählen.

Verwendet der KI-Agent alle Attribute? Der Agent hat Zugriff auf alle Attribute, die du definierst. Wie er sie einsetzt, hängt von der Verwendungseinstellung des Attributs und den aktivierten Tools ab. Informative Attribute kann der Agent im Gespräch erwähnen. Filterbare Attribute können zur Einschränkung von Suchergebnissen genutzt werden.

Kann eine Variante einen anderen Preis als das Basisprodukt haben? Ja. Füge ein Preis-Attribut direkt an der Variante hinzu. Attribute auf Variantenebene überschreiben den Standardwert auf Produktebene für diese konkrete Kombination.

Wie viele Produkte kann ich pro Agent haben? Es gibt keine feste Obergrenze. Sehr große Kataloge können die Suchantwortzeiten beeinflussen. Wenn du Tausende von Produkten verwaltest, helfen aussagekräftige Namen und Attribute dabei, Suchergebnisse präzise zu halten.

Kann ich ein Produkt mit mehreren Tools verknüpfen? Ja. Ein Produkt kann mit beliebig vielen Tools und Plugins verknüpft werden. Jeder Link wird unabhängig verwaltet, sodass du Zugriffe hinzufügen oder entfernen kannst, ohne andere Verbindungen zu beeinflussen.