KI Produktfragen Handbuch.

So generierst du pro Produkt typische Fragen und Antworten per KI und zeigst sie als Chat oder FAQ auf der Produktdetailseite.

Systemvoraussetzungen

Shopware 6.7, ein API-Key bei einem der unterstützten KI-Anbieter und ein gültiger Lizenz-Token. Das Plugin gehört zur Stone & Water Plugin-Suite.

Installation

Die Direct-Variante wird per Upload im Admin installiert, ohne SSH-Zugang. Nach dem Aktivieren erscheint der Menüpunkt unter Erweiterungen, Stone & Water - Plugin Suite.

Lizenz aktivieren

Bis zur Aktivierung zeigt der Admin einen Lizenz-Bildschirm mit Eingabefeld. Die Prüfung ist an die Shop-Domain gebunden und arbeitet fail-closed: Ohne gültige Lizenz wird das Widget in der Storefront nicht ausgegeben. Bei Ausfall des Lizenzservers gilt eine Toleranz von drei Tagen, in denen weitergearbeitet werden kann.

Zur Domain: Admin-Prüfung und Storefront prüfen gegen denselben Host. Für Staging-Systeme brauchst du daher einen eigenen Lizenzeintrag.

Einstellungen öffnen

Im Admin unter Erweiterungen, Stone & Water - Plugin Suite, KI Produktfragen. Dort liegen Anbieter-Einstellungen, die Massen-Generierung und die Einzel-Generierung.

Anbieter und Modelle

Unterstützt werden vier Anbieter: OpenAI, Anthropic, Mistral und Google. Je Anbieter hinterlegst du einen API-Key und wählst ein Modell.

Die Modellliste wird gepflegt. Ältere Modelle bleiben am Ende der Liste mit dem Zusatz „älter" erhalten, damit bestehende Konfigurationen nach einem Update unverändert weiterlaufen. Bei Mistral zeigen die Einträge auf -latest-Aliase und damit automatisch auf die jeweils neueste Version.

Prompt-Anweisung

Über die Prompt-Anweisung steuerst du Inhalt und Tonalität der erzeugten Texte dauerhaft - etwa fachlich knapp, mit Fokus auf Anwendungsfälle oder in der Ansprache deines Shops.

Massen-Generierung

Der Massenlauf erzeugt Fragen, Antworten sowie Plus- und Minuspunkte für viele Produkte am Stück. Die Verarbeitung läuft in Teilpaketen, deren Größe du über die parallele Verarbeitung steuerst. Am Ende erhältst du eine Sammelmeldung mit erzeugten, übersprungenen und fehlerhaften Produkten.

Filter und Umfang

Nur aktive Produkte
Deaktivierte Produkte werden im Massenlauf übersprungen.
Nur neue Produkte
Produkte, für die bereits Texte existieren, werden ausgelassen.
Überschreiben
Vorhandene Texte werden ersetzt statt übersprungen.
Hersteller
Einschränkung auf ausgewählte Hersteller.
Anzahl
Begrenzt, wie viele Produkte ein Lauf verarbeitet.

Einzelnes Produkt neu generieren

Für gezielte Korrekturen gibt es einen eigenen Bereich mit Produktsuche über Name oder Artikelnummer. Mehrere Produkte lassen sich nacheinander auswählen; sie erscheinen als Chips unter dem Suchfeld und können per X wieder entfernt werden. Bereits gewählte Produkte werden aus den Suchtreffern ausgeblendet.

Optional gibst du eine zusätzliche Anweisung mit, die nur für diesen Lauf gilt - etwa ein inhaltlicher Schwerpunkt oder eine andere Tonalität. Sie wird zusätzlich zur konfigurierten Prompt-Anweisung übergeben.

Ausnahme mit Absicht: Im Einzel-Modus wird das gewählte Produkt immer verarbeitet, auch wenn „Nur aktive Produkte" eingeschaltet ist.

Darstellung auf der Produktseite

Auf der Produktdetailseite erscheint ein Chat-Bereich mit Überschrift, Eingabefeld und Senden-Button. Die mitgelieferten Standardtexte lauten „Frage mich alles über dieses Produkt" als Überschrift und ein Hinweis darunter, dass der digitale Berater wie ein Mensch auch einmal danebenliegen kann.

Findet die KI zu einer Frage keine Grundlage, antwortet sie mit einem klaren Hinweis statt zu raten. Bei technischen Störungen erscheint eine Fehlermeldung mit der Bitte, es später erneut zu versuchen.

Quick-Facts einblenden

Oberhalb von Chat und FAQ lässt sich eine Reihe kompakter Chips mit den Eckdaten des Artikels einblenden: Artikelname, Artikelnummer, Hersteller, Verfügbarkeit und Preis. Jede Angabe ist einzeln zuschaltbar, und zwar je Verkaufskanal.

Wählst du keine einzige Angabe aus, erscheint der Bereich gar nicht - die Chips sind also vollständig optional.

Tipp: Weniger ist hier meist mehr. Zwei bis drei Angaben wirken als schneller Überblick, fünf Chips konkurrieren mit den Produktdaten darüber.

Varianten im Chat

Wählt der Kunde auf der Produktseite eine Variante - etwa Farbe oder Größe -, werden die gewählten Optionen der KI als Zusammenhang übergeben. Die Antworten beziehen sich damit auf die tatsächlich betrachtete Ausführung statt allgemein auf das Produkt.

Hat eine Variante keine eigene Beschreibung, greift das Plugin auf die des Hauptprodukts zurück. Damit bleiben die Antworten auch dann brauchbar, wenn die Varianten nur dünn gepflegt sind.

Plus- und Minuspunkte

Neben den Fragen und Antworten erzeugt das Plugin je Produkt eine Liste mit Plus- und Minuspunkten, die als eigener Block ausgegeben wird - gekennzeichnet mit dem Hinweis, dass sie vom KI-Produktberater stammen.

SEO-Einstellungen

Vier Einstellungen wirken auf die Sichtbarkeit in Suchmaschinen. Alle sind voreingestellt aus, bestehende Installationen ändern sich also nicht von selbst.

Eigene URL je Frage: Jede Frage bekommt eine teilbare Adresse und öffnet sich beim Aufruf automatisch. Wahlweise erscheint daneben ein Ketten-Symbol zum direkten Kopieren.FAQ-Auszeichnung: Die Fragen werden als FAQPage ausgezeichnet, damit Suchmaschinen sie in den Ergebnissen darstellen können. Die Adressen einzelner Fragen sind enthalten, sofern aktiviert.SEO-Fragenstil: Die Fragen werden als ausformulierte Suchanfragen erzeugt, die Antworten auf 40 bis 60 Wörter angelegt. Wirkt ab der nächsten Erzeugung.Interne Verlinkung: In den Antworten erwähnte Produkte werden auf ihre Produktseite verlinkt, höchstens drei je Antwort. Verlinkt werden Cross-Selling-Partner und Artikel desselben Herstellers.
Wichtig: Die FAQ-Auszeichnung setzt voraus, dass die Inhalte serverseitig ausgegeben werden. Ist das abgeschaltet, weist der Admin unterhalb des Schalters darauf hin.

Eigene FAQ-Unterseite je Produkt

Mit dieser Einstellung erscheinen alle Fragen eines Artikels zusätzlich als eigenständige, indexierbare Seite. Sie enthält die Fragen samt Antworten, die Plus- und Minuspunkte, einen eigenen Seitentitel mit Beschreibung und einen Rückverweis auf das Produkt. Das Widget verlinkt unterhalb der Fußnote dorthin.

Über "URL-Aufbau der FAQ-Unterseite" bestimmst du die Adresse: Produkt-ID, Artikelname, Artikelnummer oder Artikelname und Artikelnummer zusammen. Umlaute und Sonderzeichen werden dabei sauber in URL-taugliche Zeichen übersetzt.

Bereits geteilte Links bleiben gültig: Die Seite löst alle Adressvarianten auf, auch die reine Produkt-ID. Ein Wechsel des Musters bricht also keine Links, die schon im Umlauf sind.

Umfang der Erzeugung

In der Massenerzeugung bestimmt die Auswahl "Umfang", was neu erzeugt wird. Mit "Nur Plus-/Minuspunkte" bleiben die bestehenden Fragen unangetastet - nützlich, wenn die Fragen bereits indexiert sind und nur die Bewertung überarbeitet werden soll.

Für einzelne Produkte gibt es dafür einen eigenen Knopf. Beides spart Kosten beim KI-Anbieter, weil nur der gewünschte Teil neu erzeugt wird.

Erzeugung je Verkaufskanal

Die Kanalauswahl steht auch im Reiter Erzeugung zur Verfügung. Massen- und Einzelerzeugung nutzen dann die Einstellungen des gewählten Kanals: KI-Anbieter, Sprache, Anzahl der Fragen, Fragenstil und die gewählten Produktangaben.

Hinweis zum Speichern: Beim Speichern mit ausgewähltem Kanal werden nur noch tatsächliche Abweichungen von der allgemeinen Einstellung hinterlegt. Überflüssige Überschreibungen werden dabei aufgeräumt, damit spätere allgemeine Änderungen wieder durchschlagen.

Wo die Texte gespeichert werden

Die Texte liegen in der eigenen Tabelle staw_product_question_direct. Die Direct- und die Store-Variante nutzen bewusst getrennte Tabellen und können dadurch parallel betrieben werden. Beim Update von einer älteren Version wird eine vorhandene alte Tabelle automatisch umbenannt, die Daten bleiben erhalten.

Problemlösung

Das Widget erscheint nicht im Shop

Ohne gültige Lizenz wird es bewusst nicht ausgegeben. Prüfe außerdem, ob für das Produkt überhaupt schon Texte erzeugt wurden.

Die Generierung bricht ab oder meldet Fehler

Meist fehlt ein gültiger API-Key oder das gewählte Modell ist beim Anbieter nicht freigeschaltet. Die Sammelmeldung am Ende des Laufs nennt die Anzahl der Fehler.

Produkte werden übersprungen

Das ist der Normalfall bei aktivem „Nur neue Produkte" oder wenn Texte bereits existieren und „Überschreiben" aus ist.

Die Lizenz wird im Admin abgelehnt

Die Prüfung nutzt den Host der Anfrage. Rufst du den Admin über eine andere Domain auf als die lizenzierte, schlägt sie fehl.

Support

Bei Fragen zur Anbieterwahl, zu Prompt-Anweisungen oder zur Lizenz helfen wir gern. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.

Über den Store oder direkt bei uns.

Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Halbjährlich49,99 €17 % günstiger
Bester PreisJährlich89,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.

Mehr Vertrauen auf der PDP?

Zurück zu Produktfragen.

Alle Funktionen auf der Produktseite. Bei Einrichtung und Anbindung helfen wir gern.