KI-FAQ-Generierung

FAQs aus Produktbeschreibung & Eigenschaften per Anthropic Claude oder OpenAI

ⓘ

Verfügbar ab Version 1.3. Die KI-Generierung ist optional — ohne API-Key bleibt das Plugin unverändert und der KI-Button wird im Admin nicht angezeigt.

Konzept

SvenDasFaq ergänzt das bestehende FAQ-System um eine textbasierte KI-Generierung: Die KI bekommt Produktname, Beschreibung und Eigenschaften zu sehen und liefert eine konfigurierbare Anzahl FAQ-Vorschläge im strukturierten JSON-Format zurück. Bilder werden nicht analysiert — FAQ-Texte aus dem geschriebenen Produktinhalt sind deutlich konsistenter als visuell abgeleitete.

Im Admin erfolgt die Generierung pro Produkt mit Vorschau und Checkbox-Auswahl — nichts wird automatisch gespeichert. Für Batch-Jobs auf ganze Kategorien oder den kompletten Katalog gibt es einen CLI-Befehl.

Konfiguration

Alle Einstellungen liegen unter Erweiterungen > Meine Erweiterungen > DAS Produkt FAQ > Konfigurieren in der Karte KI-FAQ-Generierung.

Einstellung	Beschreibung	Standard
KI-Anbieter	Anthropic (Claude) oder OpenAI (GPT-4o). Bestimmt API-Endpoint und Default-Modell.	`anthropic`
API-Key	Passwort-Feld. Anthropic-Keys beginnen mit `sk-ant-`, OpenAI-Keys mit `sk-`.	—
Modell	Modell-ID. Leer = Provider-Default: • Anthropic: `claude-sonnet-4-20250514` • OpenAI: `gpt-4o`	(leer)
API-Key testen	Schaltfläche, die einen Probe-Request mit `max_tokens: 5` losschickt und ungültigen Key, fehlendes Guthaben oder unbekanntes Modell klar meldet.	—
Sprache der generierten FAQs	Deutsch oder Englisch. Steuert die Sprache, in der die KI Fragen und Antworten formuliert.	`de`
Maximale Anzahl FAQs pro Generierung	Wie viele Vorschläge die KI pro Lauf liefern darf (1–15).	`5`
Produktbeschreibung als Quelle nutzen	Wenn aktiv, fließt `product.description` (HTML wird gestrippt) in den Prompt ein.	`true`
Produkt-Eigenschaften als Quelle nutzen	Wenn aktiv, werden alle Property-Werte (Gruppe + Wert, z. B. „Material: Eiche") in den Prompt aufgenommen.	`true`
Zusätzliche Hinweise an die KI	Freitext, der dem Prompt angehängt wird — z. B. „Du-Form verwenden", „Versandzeit 2–4 Werktage" oder eine spezifische Markenstimme.	(leer)

⚠

Nach dem Speichern des API-Keys einmal „API-Key testen“ klicken — sonst weiß man im Zweifel nicht, ob der Provider erreichbar ist und das Modell für den Account freigeschaltet ist.

Admin-Workflow: KI-Vorschläge pro Produkt

Produkt im Admin öffnen, zum Block Zusatzfelder scrollen (dort liegt der FAQ-Editor).
Im FAQ-Editor auf den Button „KI: FAQs aus Produkt vorschlagen" klicken.
Im Modal die Vorschläge sichten. Jeder Eintrag hat eine Checkbox — standardmäßig sind alle ausgewählt. Was nicht passt, einfach abwählen.
Klick auf „Auswahl übernehmen": Die ausgewählten FAQs werden an die bestehende Liste angehängt.
Vor dem Speichern können die übernommenen FAQs noch ganz normal editiert werden (Frage, Antwort als Rich-Text, optional Bild).
Produkt speichern.

✓

Der KI-Button erscheint nur auf Produktdetailseiten. Im FAQ-Blocks-Modul (wiederverwendbare Blöcke) ist er bewusst ausgeblendet — Blöcke sind themen- und nicht produktspezifisch.

Was die KI sieht

Der Prompt enthält strukturiert:

Produktname (übersetzte Variante in der Admin-Sprache, Fallback auf den Hauptwert).
Produktbeschreibung als reiner Text — HTML-Tags werden entfernt, Mehrfach-Whitespace normalisiert. Nur wenn der Schalter „Beschreibung als Quelle" aktiv ist.
Eigenschaften-Liste aus der Many-to-Many-Property-Verknüpfung des Produkts, formatiert als Gruppenname: Optionsname (z. B. Material: Eiche, Stil: Mid-Century). Nur wenn der Schalter „Eigenschaften als Quelle" aktiv ist.
Bestehende FAQ-Fragen des Produkts — damit die KI weiß, was bereits abgedeckt ist, und sie nicht doppelt vorschlägt.
Zusätzliche Hinweise aus der Plugin-Konfig (optional).

Die KI liefert ein JSON im Format { "items": [ { "question": "…", "answer": "…" } ] } zurück. Die Antworten dürfen einfaches HTML enthalten (,  , <ul>, <ol>, <li>, , ). Inline-Styles, Scripts und Eventhandler werden server-seitig gestrippt, bevor der Vorschlag im Admin landet.

ⓘ

Der Prompt enthält explizit die Regel: „Stelle nur Fakten dar, die aus den Produktinfos hervorgehen. Erfinde KEINE technischen Werte, Materialien, Maße oder Garantieangaben." Das reduziert Halluzinationen, ersetzt aber nicht die redaktionelle Endabnahme im Modal.

REST-API (intern, für den Admin)

Methode	Route	Zweck
`POST`	`/api/_action/sven-das-faq/generate-product-faq`	Generiert FAQ-Vorschläge für ein Produkt — wird vom Vorschau-Modal aufgerufen. Body: `{ productId, salesChannelId? }`. Liefert `{ success, items: [{question, answer}] }`.
`POST`	`/api/sven-das-faq/test-api-key`	API-Key-Probe. Body: `{ provider, apiKey, model? }`. Liefert `{ success, message }`.

Sicherheit & Limits

API-Key liegt verschlüsselt im system_config — gleicher Mechanismus, mit dem Shopware auch andere Plugin-Passwörter speichert. Er wird im Admin niemals zurückgegeben.
HTTP-Timeout ist auf 60 Sekunden gesetzt. Bei großen Beschreibungstexten kann ein Lauf 20–40 Sekunden dauern.
Max-Tokens für die Antwort: 2048 — reicht selbst für 15 ausführliche FAQ-Einträge bequem aus.
Rate-Limits: Im CLI-Modus steuerbar via --delay (Default 500 ms zwischen Calls). Im Admin-Modus läuft pro Klick ein einzelner Request — kein Rate-Limit-Problem.
Antwort-Sanitization: Vor der Übernahme werden onclick-/style-Attribute und alle nicht-erlaubten Tags entfernt — auch wenn die KI sich nicht an den Prompt hält.

Kosten-Orientierung

Die Generierung von 5 FAQs aus einer durchschnittlich langen Produktbeschreibung kostet ungefähr:

Anthropic Claude Sonnet 4: ~ 0,003 – 0,01 € pro Produkt
OpenAI GPT-4o: ~ 0,005 – 0,015 € pro Produkt

Ein Batch über 500 Produkte kostet damit zwischen ungefähr 1,50 und 7,50 € — abhängig von der Länge der Beschreibungen und der Anzahl Properties. Vor einem großen Lauf empfiehlt sich --dry-run --limit=10 mit Blick auf das eigene Provider-Dashboard.

Weiter: CLI-Befehle für den Batch-Workflow.