Installationsanleitung
Erweiterung über den Erweiterungsbereich installieren.
OpenAI API Schlüssel
- Gehe zu https://platform.openai.com/.
- Melde dich an.
- Erstelle ein neues Projekt.
- Gehe zu deinem Profil und gehe zum „API keys“ Bereich https://platform.openai.com/settings/organization/api-keys.
- Erstelle einen neuen API Schlüssel über „Create new secret key“.
- Lade Guthaben auf, damit die OpenAI API funktioniert. https://platform.openai.com/settings/organization/billing/overview
- Optional: Wir empfehlen, dass ein Limit für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://platform.openai.com/settings/organization/limits

Gemini-API-Key (Google AI Studio)
- https://aistudio.google.com/ aufrufen und mit dem Google-Account anmelden
- Links im Menü auf Get API key klicken
- Create API key wählen und ggf. ein neues Google-Cloud-Projekt anlegen lassen
- Den erzeugten Schlüssel kopieren
- Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
- Optional: Wir empfehlen, dass eine Ratenbegrenzung für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://aistudio.google.com/rate-limit

Claude-API-Key (Anthropic Console)
- https://console.anthropic.com/ aufrufen und einloggen / registrieren
- Links im Menü auf API Keys klicken
- Create Key wählen, einen Namen vergeben (z.B. „Shopware – <Shopname>“) und bestätigen
- Den angezeigten Schlüssel sofort kopieren (er wird nur einmal angezeigt)
- Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
- Optional: Wir empfehlen, dass ein Limit für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://platform.claude.com/settings/limits

Mistral API Schlüssel
Gehe zu https://console.mistral.ai/
Account erstellen oder einloggen
API Key erstellen und in Shopware-Erweiterung eintragen
Guthaben aufladen
Hinweis: Europäischer Anbieter (DSGVO-konform)
Einrichten der Erweiterung in Shopware
API-Berechtigungsnachweise
- Trage den API Schlüssen ein, dieser sollte bei OpenAI mit „sk-proj“ anfangen.
- Wähle dein gewünschten KI-Modell aus.
OpenAI Frontend Assistent
Eine Auswahl ist nur verfügbar, wenn ein Frontend Assistent erstellt wurde.
- Um einen Frontend Assistenten zu erstellen, gehe zu Kataloge -> OpenAI Assistant Frontend.
- Wähle „neuen Assistant hizufügen“.
- Die Assistant-ID wird automatisch erstellt.
- Wähle deinen gewünschten Verkaufskanal aus.
- Benenne deinen Assistenten, damit er leicht erkennbar ist.
- Wähle aus, ob du einen Formellen oder weniger Formellen Ton möchtest.
- Hinterlege zusätzliche Informationen für den Assistenten, wie gesonderte Anweisungen oder eine FAQ.
- Wähle hier das KI-Modell aus.
- Die Temperatur gibt an, wie zufällig die Antworten der KI sind. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant
- Top P ist ähnlich wie Temperatur eine alternative Sampling Methode. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant#assistants-modifyassistant-top_p
- Die Design Farbe des Frontend Assistenten orientiert sich an der „Primärfarbe“ im Theme.
- Die Texte des Frontend Assistenten können über die Textbausteine angepasst werden:
- Die Textbausteine befinden sich unter Einstellungen, in Shopware 6.6 Einstellungen->Shop.
- Über das Suchfenster in dem Textbaustein Set kann nach „biloba.openAI“ gesucht werden.
- Hier finden sich dann dann folgende Werte die angepasst werden können:




Chat-Aufbewahrung (DSGVO)
In der Assistent-Konfiguration legt das Feld „Chat-Aufbewahrung in Tagen“ fest, wie lange Frontend-Assistant-Chats gespeichert bleiben:
- Leer / nicht gesetzt → unbegrenzte Aufbewahrung
- 0 → unbegrenzte Aufbewahrung
- N > 0 → Chats, die älter als N Tage sind, werden täglich um 01:30 automatisch gelöscht (Cron
chat:retention:clean).
DSGVO-Default: Bei neu angelegten Assistenten sowie bei bestehenden Assistenten ohne gesetzten Wert greift automatisch eine Aufbewahrungsdauer von 7 Tagen, sobald das Plugin aktualisiert wurde.
Auto-Kategorisierung der Chats (Frontend Assistent Plus)
Premium-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“. Ohne aktiven IAP sind Toggle, Filter und Spalte ausgeblendet.
Frontend-Assistent-Chats werden automatisch in eine von 7 Kategorien eingeordnet:
- Versand
- Retoure
- Produkt
- Preis
- Verfügbarkeit
- Technisch
- Sonstiges
Die Kategorisierung läuft im stündlichen Hintergrundjob chat:analyze und greift Threads ab, die mindestens 30 Minuten inaktiv waren. Ist zusätzlich das Confidence-Scoring aktiviert (siehe nächster Abschnitt), erledigt der Job beides in einem KI-Call pro Chat.
Im Admin-Backend des Plugins:
- Im Assistent-Edit-Formular: neuer Toggle „Auto-Kategorisierung der Chats“
- Im Tab „Assistant Frontend Log“: neuer Filter „Kategorie“ und neue Spalte „Kategorie“ in der Chat-Liste
- Die Kategorie wird zusätzlich in den CSV-Export geschrieben
Confidence-Scoring & Inhaltslücken-Auswertung (Frontend Assistent Plus)
Premium-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“. Ohne aktiven IAP sind Toggle, Filter, Button und der zugehörige Tab ausgeblendet.
Nach einem abgeschlossenen Chat (mindestens 30 Minuten inaktiv) bewertet die KI auf einer Skala von 0 bis 10, wie gut der Bot geantwortet hat — 10 = perfekt getroffen, 0 = Anliegen komplett verfehlt. Die Bewertung läuft im selben stündlichen Cron chat:analyze wie die Auto-Kategorisierung (ein gemeinsamer KI-Call, wenn beide Toggles aktiv sind).
Konfiguration pro Assistent:
- Toggle „Confidence-Scoring aktivieren“
- Schwellwert „Niedrige Confidence ab“ (Default: 5) — Chats mit einer Bewertung ≤ Schwellwert gelten als schwach.
Im Tab „Assistant Frontend Log“:
- Neue Spalte „Confidence“ zeigt den Score je Chat.
- Filter „Nur niedrige Confidence“ blendet ausschließlich Chats unterhalb des Schwellwerts ein.
- Mehrfach-Auswahl der Zeilen über Checkboxen.
- Button „Inhaltslücken auswerten“ startet einen Job, der die markierten schwach bewerteten Chats sammelt, gemeinsam analysiert und einen Bericht über fehlende Inhalte, FAQs und Hilfeseiten im Shop erstellt.
Wo finde ich die Berichte? Im neuen Tab „Inhaltslücken-Berichte“ (siehe Abschnitt „OpenAI – Logs & Daten“).
Überprüfen der Shopdaten beim OpenAI Assistenten
Der Assistent erfasst alle 24 Stunden die Shopdaten und speichert sie als Dateien, welche bei OpenAI in die Vektordatenbank geladen werden. Die Dateien können jederzeit heruntergeladen und geprüft werden.

Einstellungen „Alle META-Tags Produkt / Kategorie (konfiguriert)“
Einstellungen für die Erstellung der SEO Daten in der Massenbearbeitung. Diese Einstellung sind nur für die Massenbearbeitung oder für den Button „Alle META-Tags (konfiguriert)“ im Einzelmodus.

Erzeugen von META-Informationen für Bilder
- Automatische Generierung ausgewählter META-Informationen beim Erstellen oder Aktualisieren von Bildern: diese Einstellung ermöglicht es, dass die META-Informationen für Bilder direkt beim hochladen oder beim aktualisieren eingefügt werden. Dies funktioniert automatisch, bitte prüfe deine OpenAI Limits.
- Diese Option funktioniert NICHT mit dem Produktkontext. Damit Meta Daten mit dem Produktkontext generiert werden können, muss der Artikel vorher mit dem gewünschten Bild gespeichert werden. Das ist für die Zuordnung nötig.
- Auswahl der zu generierenden Sprachen (Standardsprache wird immer generiert): eine Liste der Sprachen, in welchen die META- Informationen erstellt werden.
- Checkboxen, welche Information in der Massenbearbeitung und beim automatisierten erstellen bearbeitet werden.
- Wenn du einen Htaccess für deinen Shop aktiv hast, musst du diese Anmeldedaten hier eintragen, damit die Bild META-Informationen erstellt werden können. Dies ist nötig, da die Bilder von OpenAI analysiert werden und ein Zugriff benötigt wird.

Allgemeine Einstellungen
- Schlüsselwörter: Globale Schlüsselwörter, welche von der KI bei der META Generierung berücksichtigt werden sollen.
- Höfliche Form: Welche Form beim erstellen der Texte genutzt wird.
- Die Temperatur gibt an, wie zufällig die Antworten der KI sind. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant#assistants-modifyassistant-temperature
- Top P ist ähnlich wie Temperatur eine alternative Sampling Methode. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant#assistants-modifyassistant-top_p
KI Verarbeitung Einzelentität
Produktbeschreibung
- Gehe zu Kataloge -> Produkte und wähle dein gewünschtes Produkt aus.
- Wenn eine Produktbeschreibung steht, wird diese und der Produkttitel genommen.
- Wenn keine Beschreibung vorhanden ist, trage bitte einen Text von 50-1000 Zeichen ein. Dieser wird für die Erstellung der Beschreibung genutzt.

Produkte SEO Daten
- Gehe zu Kataloge -> Produkte und wähle dein gewünschtes Produkt aus.
- im SEO Bereich können Meta-Titel, Meta-Beschreibung und Keywords erstellt werden.
- Nutze Hierfür den entsprechenden Button um deine gewünschten SEO Daten zu erstellen oder alle drei.

Produkte Bilder Meta Daten
- Gehe zu Kataloge->Produkte und wähle dein gewünschtes Produkt aus.
- Gehe zum Bilder Bereich.
- Hier können für bereits gespeicherte Bilder Meta Daten generiert werden.
- Bitte beachte, dass Meta Daten nur generiert werden, wenn der Artikel mit den gewünschten Bildern gespeichert wurde.

KI-Texte für Freitextfelder (Custom Fields) auf der Produktseite (Prompts Plus)
Premium-Funktion: Diese Funktion erfordert den In-App-Kauf „Prompts Plus“. Ohne aktiven IAP ist die Box ausgeblendet.
Auf der Produktseite im Tab „Freitextfelder“ steht eine neue Box zur Verfügung, mit der KI-Texte direkt in textfähige Custom Fields geschrieben werden können:
- Dropdown mit allen textfähigen Custom Fields des Produkts
- „Generieren“-Button zum Anstoßen der KI-Texterstellung
- Status-Anzeige während der Generierung
Ideal für strukturierte Zusatzinformationen wie Pflegehinweise, technische Daten oder USPs, die in eigenen Custom Fields auf der Produktseite gepflegt werden.
Kategorie Beschreibung
- Gehe zu Kataloge -> Kategorien und wähle deine gewünschte Kategorie aus.
- Wenn eine Produktbeschreibung steht, wird diese und der Produkttitel genommen.
- Wenn keine Beschreibung vorhanden ist, trage bitte einen Text von 50-1000 Zeichen ein. Dieser wird für die Erstellung der Beschreibung genutzt.

Kategorie SEO Daten
- Gehe zu Kataloge -> Kategorien und wähle deine gewünschte Kategorie aus.
- im SEO Bereich können Meta-Titel, Meta-Beschreibung und Keywords erstellt werden.
- Nutze Hierfür den entsprechenden Button um deine gewünschten SEO Daten zu erstellen oder alle drei.

Textbearbeitung Bulk
- Gehe zu Kataloge -> Open AI – Massenupdate.
- in „Bereich“ kann der gewünschte Bereich ausgewählt werden, der bearbeitet werden soll.
- Produktbeschreibung
- Produkt-META-Informationen
- Bild-Alt und Titel-Text
- Einzelne Einstellungen für die verschiedenen Bereiche sind vorhanden
- Filter gibt an, ob bei der Auswahl der zu bearbeitenden Bereiche was beachtet werden soll, wie nur Entitäten bearbeiten, welche noch nicht von der KI bearbeitet wurden
- Sprachen gibt an, welche Sprache bearbeitet werden soll.
- Kategorien bietet eine Kategorie Auswahl an. Dies dient zur Eingrenzung der zu bearbeitenden Entitäten. Wähle alle Kategorien mit Shift+Klick aus um alle Entitäten zu bearbeiten.
- Weiter folgend die gefundenen Entitäten, welche bearbeitet werden.
- in dem „Aktuell laufende Bulk-Jobs“ Bereich, wird angezeigt, ob gerade ein Job am laufen ist

Prompting
Überblick
Das Prompting Modul ermöglicht es, die KI-Textgenerierung anzupassen und zu verändern. Es ist möglich die vorgegebenen Prompt zu erweitern oder zu ersetzen. Es ist ein Grundsätzliches Verständnis für Prompting vorausgesetzt, daher ist dieses Modul nur für „Experten“ empfohlen.
Zugriff auf das Prompting-Modul
Das Prompting-Modul ist über zwei Wege erreichbar:
- Über die Einstellungen: Navigiere zu Einstellungen → Plugins → Open AI Prompts.
- Über das Massenupdate: Im Massenupdate-Modul findest du einen Link „Prompts konfigurieren“ direkt in der Konfigurationsansicht.
Verfügbare Bereiche
In dieser App stehen Ihnen folgende Bereiche zur Verfügung:
- Produktbeschreibung: Generierung von Produkttexten
- Produkt Meta-Titel: SEO-optimierte Produkttitel
- Produkt Meta-Beschreibung: SEO-Beschreibungen für Produkte
- Produkt Meta-Keywords: Relevante Keywords für Produkte
- Kategoriebeschreibung: Kategorietexte
- Kategorie Meta-Daten: SEO-Daten für Kategorien
- Medien Meta-Daten: Alt-Texte und Titel für Bilder, Produktkontext kann hier eingestellt werden. Bitte Hinweis Beachten.
Konfigurationsmöglichkeiten pro Bereich
1. Zusätzlicher Prompt (Optional)
- Hier können spezielle Anweisungen ergänzt werden, die zusätzlich zum Standard-System-Prompt an die KI gesendet werden.
2. Verfügbare Variablen
- Für jeden Bereich werden die verfügbaren Variablen angezeigt.
- Variablen können direkt angeklickt werden, um sie in den zusätzlichen Prompt einzufügen.
- Die Variablen werden automatisch an der Cursor-Position im Text eingefügt.
- Verfügbare Variablen je nach Bereich:
##targetLanguage##– Zielsprache##productName##– Produktname##productText##– Produktbeschreibung##productNumber##– Artikelnummer/MPN##productManufacturerName##– Herstellername##productManufacturerDescription##– Herstellerbeschreibung##categoryName##– Kategoriename##categoryText##– Kategoriebeschreibung##lengthFrom##/##lengthTo##– Textlängen-Vorgaben##keywords_amount##– Anzahl der Keywords##productProperties##– Technische Produkteigenschaften aus Shopware (z. B. „Farbe: Schwarz, Material: Metall, Größe: XL“). Nur verfügbar, wenn der Toggle „Produkteigenschaften einbeziehen“ aktiv ist.##productCategories##– Produktkategorien aus Shopware (z. B. „Beleuchtung, Deckenleuchten, LED“). Nur verfügbar, wenn der Toggle „Produktkategorien einbeziehen“ aktiv ist. Hilft dem KI-Modell, den Produkttyp zu verstehen und vermeidet Halluzinationen bei unklaren Produktnamen.##productImageMeta##– Titel und Alt-Texte der Produktbilder (z. B. „Schwarze Deckenleuchte Vorderansicht (Alt: Moderne LED-Deckenleuchte)“). Nur verfügbar, wenn der Toggle „Produktbild-Informationen einbeziehen“ aktiv ist.
3. KI-Modell Auswahl
- Es kann das OpenAI-Modell für die Textgenerierung ausgewählt werden.
- Verschiedene Modelle haben unterschiedliche Stärken und Kosten:
- GPT-5.5: Neuestes Top-Modell, beste Qualität für komplexe Aufgaben
- GPT-5 Mini: Schnell und kostengünstig, ideal für große Mengen
- GPT-5: Ausgewogene Leistung und Qualität
- GPT-5 Nano: Kompaktes Modell für einfache Aufgaben
- GPT-4.1 Serie: Ältere Modelle, weiterhin verfügbar
4. System-Prompt Einstellungen
- Der Standard-System-Prompt enthält die grundlegenden Anweisungen für die KI.
- Option „Standard-System-Prompt deaktivieren“: kann verwendet werden, wenn die komplette Kontrolle übernehmen werden soll. Bitte nur aktivieren, wenn dumit Prompting vertraut bist.
- Der aktuelle System-Prompt wird zur Transparenz angezeigt.
5. Toggle-Einstellungen
- In den Prompt-Einstellungen (Einstellungen → Erweiterungen → Open AI Prompts) gibt es pro Prompt-Typ drei Toggles zur Steuerung des Kontexts:
- Produkteigenschaften einbeziehen – steuert, ob
##productProperties##mit Daten befüllt wird. - Produktkategorien einbeziehen – steuert, ob
##productCategories##mit Daten befüllt wird. - Produktbild-Informationen einbeziehen – steuert, ob
##productImageMeta##mit Daten befüllt wird. - Standardmäßig sind alle Toggles aktiviert. Deaktivieren spart Token-Kosten, reduziert aber den Kontext für die KI.
Wichtiger Hinweis: Die Variablen werden automatisch ausgeblendet, wenn das jeweilige Produkt keine passenden Daten hat (z. B. keine Kategorie zugewiesen). Die ##IF_variableName##...##ENDIF_variableName##-Blöcke im System-Prompt werden dann entfernt.
Wichtige Hinweise für Prompting
Achtung bei Prompt-Anpassungen:
- Prompts sollten nur angepasst werden, wenn du dich mit Prompting auskennst.
- Alle Anpassungen erfolgen auf eigenes Risiko.
- Teste Änderungen zuerst im Einzelmodus oder bei der Massenbearbeitung mit wenigen Elementen.
- Der tatsächlich abgesendete Prompt kann im Logging-Modul in der Detailansicht kontrolliert werden.
Best Practices für eigene Prompts
- Sei spezifisch: Je genauer Ihre Anweisungen, desto besser das Ergebnis.
- Nutze Variablen: Verwende die verfügbaren Variablen für dynamische Inhalte.
- Teste schrittweise: Beginne mit kleinen Änderungen und teste die Ergebnisse.
- Beispiele sind hilfreich: Gebe der KI Beispiele für den gewünschten Stil.
- Längenangaben beachten: Nutze die Längenvariablen für präzise Textlängen.
Beispiele für zusätzliche Prompts
Für Produktbeschreibungen:
Schreibe in einem enthusiastischen Ton und verwende Aufzählungspunkte für die wichtigsten Features.
Beginne mit einem packenden Einleitungssatz, der das Hauptproblem anspricht, das ##productName## löst.
Für Meta-Titel:
Integriere immer den Herstellernamen ##productManufacturerName## am Anfang des Titels.
Verwende action-orientierte Wörter wie "Kaufen", "Bestellen" oder "Entdecken".
Für Kategoriebeschreibungen:
Strukturiere die Beschreibung in 3 Absätze:
1. Einleitung zur Kategorie
2. Hauptvorteile der Produkte in dieser Kategorie
3. Call-to-Action zum Stöbern
Logging und Kontrolle
Nach der Textgenerierung kann im Logging-Modul überprüft werden:
- Welcher Prompt tatsächlich an die KI gesendet wurde.
- Wie die Variablen ersetzt wurden.
- Welches Ergebnis generiert wurde.
Dies hilft Ihnen, Ihre Prompts kontinuierlich zu optimieren.
Tipps zur Fehlerbehebung
- Zu kurze/lange Texte: Passe die Längenangaben in der Plugin-Konfiguration an.
- Falscher Ton: Ergänze spezifische Ton-Anweisungen im zusätzlichen Prompt.
- Fehlende Informationen: Stelle sicher, dass alle benötigten Produktdaten gepflegt sind.
- Inkonsistente Ergebnisse: Verwende spezifischere Anweisungen oder wechsel das Modell.
Custom Fields als Prompt-Variablen (Prompts Plus)
Premium-Funktion: Variablen werden nur bei aktivem In-App-Kauf „Prompts Plus“ durch die zugehörigen Custom-Field-Werte ersetzt.
Innerhalb von Prompts können eigene Custom Fields aus Produkten, Kategorien und Eigenschaften als Variablen eingesetzt werden. Beim Generieren ersetzt die KI diese Platzhalter automatisch durch die entsprechenden Werte:
##productCustomField_<name>##— Wert eines Produkt-Custom-Fields (<name>= technischer Name des Custom Fields)##categoryCustomField_<name>##— Wert eines Kategorie-Custom-Fields##propertyCustomField_<name>##— Wert eines Property-Custom-Fields
Beispiel:
„Schreibe eine Produktbeschreibung mit Schwerpunkt ##productCustomField_pflegehinweise## und ##productCustomField_materialien##.“
Ohne aktiven Prompts Plus IAP bleiben die Platzhalter unverändert im generierten Text stehen und werden nicht ersetzt.
OpenAI – Logs & Daten
Das Modul „OpenAI – Logs & Daten“ (vormals „OpenAI – Log“) notiert jeden Job, der für die entsprechenden Bereiche gelaufen ist. Wenn ein Job nicht durchläuft, ist der Log die erste Anlaufstelle. Zusätzlich bündelt das Modul die Tabs FAQ und Inhaltslücken-Berichte.
Gehe zu Kataloge -> OpenAI – Logs & Daten
Entity Log
Hier werden die einzelnen Entitäten eingetragen, welche von der KI bearbeitet werden und nach Bereichen sortiert.

Bulk Log
Hier werden die Bulk Log – Jobs eingetragen.

Assistant Frontend Log
Hier werden die Nachrichten der Kunden mit dem Frontend Assistenten eingetragen und in der Detailansicht kann nachgesehen werden, wie der Assistent darauf reagiert.


Häufige Fehler – Einträge im Log:
- error_no_credits: gibt an, dass kein Guthaben im OpenAI Account hinterlegt ist.
Chat-Fragen exportieren (CSV)
Über den Button „Chat-Fragen exportieren“ im Tab „Assistant Frontend Log“ können alle Chat-Verläufe als CSV heruntergeladen werden. Pro Thread wird eine eigene Spalte erzeugt, die die Frage-Antwort-Paare enthält — getrennt durch ---.
Vor dem Export kann das Ergebnis gefiltert werden nach:
- Datum (Zeitraum)
- Verkaufskanal
- Kategorie (nur mit aktiver Auto-Kategorisierung)
FAQ aus Chat erstellen
In der Detailansicht eines Chats (Klick auf einen Eintrag im „Assistant Frontend Log“) steht der Button „FAQ aus Chat erstellen“ zur Verfügung. Die KI schlägt auf Basis des Chat-Verlaufs eine Frage und eine passende Antwort vor. Du kannst beide Texte vor dem Speichern bearbeiten.
Alle so erstellten FAQs werden im neuen Tab „FAQ“ verwaltet (siehe unten) und stehen anschließend dem Frontend-Assistenten als Wissensquelle zur Verfügung.
FAQ
Im Tab „FAQ“ verwaltest du alle händisch oder per „FAQ aus Chat erstellen“ angelegten FAQ-Einträge. Pro Eintrag siehst du Frage, Antwort, zugewiesenen Verkaufskanal sowie Erstellungs-/Änderungsdatum. Einträge lassen sich bearbeiten, deaktivieren und löschen.
Inhaltslücken-Berichte (Frontend Assistent Plus)
Premium-Funktion: Erfordert den In-App-Kauf „Frontend Assistent Plus“.
Im Tab „Inhaltslücken-Berichte“ findest du alle Auswertungen, die du über den Button „Inhaltslücken auswerten“ im Assistant Frontend Log angestoßen hast. Jeder Bericht zeigt, welche Themen, FAQs oder Hilfeseiten im Shop fehlen oder ergänzt werden sollten — abgeleitet aus den schwach bewerteten Chats der jeweiligen Auswahl.
MCP-Server Verwaltung
Was sind MCP-Server?
MCP-Server (Model Context Protocol) sind externe Dienste, die der KI zusätzliche Fähigkeiten verleihen. Während der Textgenerierung kann die KI diese Server kontaktieren, um Echtzeitdaten abzurufen – zum Beispiel aktuelle SEO-Keywords, Suchvolumen oder Wettbewerbsanalysen.
Server hinzufügen
Um einen neuen MCP-Server hinzuzufügen:
- Klicke auf „Server hinzufügen“
- Gib einen Namen für den Server ein (z.B. „SEO Keywords“)
- Wähle den Server-Typ aus der Liste
- Trage die erforderlichen Zugangsdaten ein (API-Key, URL, etc.)
- Speichere die Konfiguration
Server testen
Nach dem Speichern kannst du die Verbindung testen:
- Klicke auf das Test-Symbol neben dem Server
- Der Server wird kontaktiert und die verfügbaren Tools werden abgerufen
- Bei erfolgreicher Verbindung siehst du eine Bestätigung
Server mit Prompts verknüpfen
Damit ein MCP-Server bei der Textgenerierung verwendet wird:
- Gehe zu den Prompt-Einstellungen
- Wähle den gewünschten Prompt-Typ (z.B. „Produkt Beschreibung“)
- Im Abschnitt „MCP-Server“ wähle die Server aus, die verwendet werden sollen
- Speichere die Einstellungen
Die KI nutzt dann automatisch die verknüpften Server während der Generierung.
Fehlerbehebung
Server-Verbindung fehlgeschlagen:
- Überprüfe die Zugangsdaten (API-Key, URL)
- Stelle sicher, dass der Server erreichbar ist
- Prüfe, ob dein API-Kontingent noch nicht erschöpft ist
Keine Tools verfügbar:
- Der MCP-Server antwortet möglicherweise nicht korrekt
- Kontaktiere den Anbieter des MCP-Servers
Generierung dauert länger:
- MCP-Server-Anfragen können die Generierungszeit verlängern
- Dies ist normal, da zusätzliche Daten abgerufen werden
In-App Käufe
Was ist Prompts Plus?
Prompts Plus ist ein optionales Upgrade, das erweiterte Funktionen für deine KI-Textgenerierung freischaltet. Das wichtigste Feature ist die MCP-Server-Integration, mit der du externe Datenquellen einbinden kannst.
Enthaltene Funktionen
- MCP-Server-Integration: Verbinde externe Tools und Datenquellen
- Erweiterte Prompt-Optionen: Verknüpfe Server mit spezifischen Prompts
- Echtzeit-Datenabfragen: Die KI greift während der Generierung auf aktuelle Daten zu
Kauf und Aktivierung
- Der Kauf erfolgt direkt über den Shopware Store
- Nach dem Kauf wird das Feature automatisch aktiviert
- Du siehst den Status in der „In-App Käufe“ Übersicht im Log-Bereich
Abonnement-Informationen
- Prompts Plus ist ein monatliches Abonnement
- Die verbleibende Laufzeit siehst du in der „In-App Käufe“ Übersicht
- Das Abonnement verlängert sich automatisch über den Shopware Store
Systemvoraussetzungen
- Shopware Version 6.6.9.0 oder höher
- Aktive Internetverbindung für MCP-Server-Kommunikation
DSGVO-Einwilligungen protokollieren
Überblick
Der KI-Shop-Assistent (Frontend Chatbot) kann auf Wunsch serverseitig protokollieren, wann ein Storefront-Nutzer der Chatbot-Nutzung zugestimmt hat. Diese Funktion dient der Nachweispflicht gemäß Art. 6 Abs. 1 lit. a DSGVO und ist nur erforderlich, wenn dein Datenschutzbeauftragter eine dokumentierte Einwilligung verlangt.
Alle Daten werden pseudonymisiert gespeichert — es werden keine Klarnamen, E-Mail-Adressen oder IP-Adressen im Klartext erfasst.
Voraussetzung: In-App-Kauf „Frontend Assistent Plus“
Die Einwilligungs-Protokollierung ist eine Premium-Funktion und erfordert den In-App-Kauf „Frontend Assistent Plus“.
So erwirbst du den In-App-Kauf
- Öffne im Shopware-Admin den KI-Shop-Assistenten
- Navigiere zum Tab „Logging“
- Dort siehst du ein Banner: „Premium-Funktion: Frontend Assistent Plus“
- Klicke auf „Jetzt freischalten“ — es öffnet sich der Shopware In-App-Kauf-Dialog
- Nach Abschluss des Kaufs wird die Funktion sofort freigeschaltet
Alternativ kannst du den Kauf auch direkt in den Assistenten-Einstellungen (Tab „Frontend Assistent“) über den dort angezeigten Freischalte-Banner auslösen.
Hinweis: Der In-App-Kauf erfordert mindestens Shopware 6.6.9.0.
Einwilligungs-Protokollierung aktivieren
Nach dem Erwerb des In-App-Kaufs musst du die Protokollierung pro Assistent einzeln aktivieren:
- Öffne im Shopware-Admin den KI-Shop-Assistenten
- Navigiere zum Tab „Frontend Assistent“
- Bearbeite den gewünschten Assistenten
- Aktiviere den Schalter „DSGVO-Einwilligungen protokollieren“
- Speichere die Änderungen
Beide Bedingungen müssen erfüllt sein, damit Einwilligungen tatsächlich protokolliert werden:
- Der In-App-Kauf „Frontend Assistent Plus“ muss aktiv sein
- Der Schalter „DSGVO-Einwilligungen protokollieren“ muss für den jeweiligen Assistenten eingeschaltet sein
Was wird protokolliert?
Wenn ein Storefront-Besucher den Einwilligungsdialog des Chatbots akzeptiert, werden folgende Daten erfasst:
- Zeitstempel: Datum und Uhrzeit der Einwilligung
- Thread-ID: Kennung der Chat-Konversation (wird nachträglich zugeordnet, sobald die erste Nachricht gesendet wird)
- Einwilligungstext-Version: SHA-256-Hash des Einwilligungstextes — damit ist nachvollziehbar, welcher exakte Wortlaut akzeptiert wurde
- IP-Hash: Pseudonymisierter Hash der IP-Adresse (die echte IP wird nicht gespeichert)
- User Agent: Browser-Kennung des Nutzers
Pseudonymisierung
Die IP-Adresse wird vor dem Speichern mit einem serverseitigen Schlüssel gehasht (SHA-256). Aus dem Hash kann die ursprüngliche IP-Adresse nicht rekonstruiert werden. Es werden keine personenbezogenen Daten wie Name, E-Mail oder Kundennummer erfasst.
Einwilligungstext-Versionierung
Der vollständige Einwilligungstext wird einmalig auf dem Server archiviert. Bei jeder Einwilligung wird über den Hash geprüft, welche Version des Textes der Nutzer akzeptiert hat. So kann auch bei nachträglichen Textänderungen lückenlos nachgewiesen werden, welchem Wortlaut zugestimmt wurde.
Einwilligungs-Logs einsehen
So kannst du die protokollierten Einwilligungen im Shopware-Admin einsehen:
- Öffne den KI-Shop-Assistenten
- Navigiere zum Tab „Logging“
- Wähle den Unter-Tab „DSGVO-Einwilligungen“ aus
Tabellenansicht
Die Log-Übersicht zeigt dir folgende Spalten:
- Zeitstempel: Datum und Uhrzeit der Einwilligung
- Thread-ID: Klickbar — öffnet ein Detailfenster mit dem vollständigen Chat-Verlauf
- Version (Hash): Klickbar — zeigt den vollständigen Einwilligungstext
- IP-Hash: Pseudonymisierter IP-Hash
- User Agent: Browser-Kennung
Filtermöglichkeiten
- Datumsfilter: Grenze den Zeitraum über Von/Bis ein
- Seitengröße: Wähle zwischen 10, 20, 25 (Standard), 50 oder 100 Einträgen pro Seite
Detail-Ansichten
Version-Detail (Klick auf Hash):
- Vollständiger Einwilligungstext, dem zugestimmt wurde
- Zeitstempel der Einwilligung
- Vollständiger SHA-256-Hash (kopierbar)
- Vollständiger IP-Hash (kopierbar)
- Vollständiger User Agent (kopierbar)
Thread-Detail (Klick auf Thread-ID):
- Vollständiger Chat-Verlauf der Konversation
- Thread-ID (kopierbar)
- Letztes Aktualisierungsdatum
- Hinweis, falls der Thread bereits gelöscht wurde
CSV-Export
Du kannst die Einwilligungs-Logs als CSV-Datei exportieren:
- Klicke im Tab „DSGVO-Einwilligungen“ auf den Export-Button
- Es wird eine CSV-Datei heruntergeladen (consent_logs_YYYY-MM-DD_HHmmss.csv)
Die CSV-Datei enthält: consented_at, thread_id, consent_text_version, ip_hash, user_agent (Semikolon-getrennt, UTF-8 mit BOM für Excel-Kompatibilität).
Der CSV-Export steht nur zur Verfügung, wenn der In-App-Kauf „Frontend Assistent Plus“ aktiv ist.
Datenlöschung
Wenn dein Shop aus dem System entfernt wird (z.B. bei Deinstallation der App), werden alle zugehörigen Einwilligungs-Logs automatisch gelöscht. Es verbleiben keine Daten im System.
Zusammenfassung des Ablaufs
- Storefront-Besucher öffnet den Chatbot
- Einwilligungsdialog wird angezeigt
- Besucher klickt „Akzeptieren“
- Einwilligung wird pseudonymisiert auf dem Server protokolliert (nur wenn IAP aktiv UND Protokollierung eingeschaltet)
- Besucher startet Chat → Thread-ID wird nachträglich dem Log-Eintrag zugeordnet
- Du kannst die Logs im Admin einsehen, filtern und als CSV exportieren
FAQs
KI Shop-Assistent: Allgemeine Fragen
Open AI: Allgemeine Fragen
Support
Bei Fragen oder Problemen stehen wir zur Verfügung:
- Support-Anfrage: biloba-it.de/shopware-plugin-support
- E-Mail: support@biloba-it.de
- Telefon: +49 (0) 711 – 13633800
Keine Lösung gefunden?
Beschreibe uns Dein Problem – wir schauen uns das an und melden uns schnellstmöglich.



