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.

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.

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.