All-in-One KI Shop Assistent (ChatGPT | Gemini | Claude): Installation und Einrichtung


Installationsanleitung, Dokumentation und FAQs zum Shopware Plugin

Installationsanleitung

Erweiterung über den Erweiterungsbereich installieren.

OpenAI API Schlüssel

  1. Gehe zu https://platform.openai.com/.
  2. Melde dich an.
  3. Erstelle ein neues Projekt.
  4. Gehe zu deinem Profil und gehe zum “API keys” Bereich https://platform.openai.com/settings/organization/api-keys.
  5. Erstelle einen neuen API Schlüssel über “Create new secret key”.
  6. Lade Guthaben auf, damit die OpenAI API funktioniert. https://platform.openai.com/settings/organization/billing/overview
  7. 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
Erstellen eines neuen API Schlüssels

Gemini-API-Key (Google AI Studio)

  1. https://aistudio.google.com/ aufrufen und mit dem Google-Account anmelden
  2. Links im Menü auf Get API key klicken
  3. Create API key wählen und ggf. ein neues Google-Cloud-Projekt anlegen lassen
  4. Den erzeugten Schlüssel kopieren
  5. Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
  6. 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)

  1. https://console.anthropic.com/ aufrufen und einloggen / registrieren
  2. Links im Menü auf API Keys klicken
  3. Create Key wählen, einen Namen vergeben (z.B. „Shopware <Shopname>“) und bestätigen
  4. Den angezeigten Schlüssel sofort kopieren (er wird nur einmal angezeigt)
  5. Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
  6. 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üssel deines KI-Anbieters ein (OpenAI, Claude, Gemini oder Mistral). Ein OpenAI-Schlüssel beginnt mit „sk-proj“.
  • Für den Chatbot brauchst du einen OpenAI-API-Schlüssel. Der Chatbot unterstützt ausschließlich OpenAI. Claude, Gemini und Mistral kannst du für Texte, SEO-Daten und Bildtexte nutzen.
  • Das KI-Modell wählst du nicht hier, sondern je Prompt-Typ unter Einstellungen → Erweiterungen → Biloba AI Prompts und je Chatbot im Tab „Modell“.

Chatbot (Frontend-Assistent) einrichten

Der Chatbot erscheint erst im Shop, wenn du ihn angelegt und in der App-Konfiguration eingeschaltet hast.

  • Gehe zu Kataloge → Biloba AI – Chatbot und klicke auf „Neuen Chatbot hinzufügen“.
  • Die Chatbot-ID wird automatisch erstellt.
  • Wähle im Tab „Allgemein“ den Verkaufskanal aus und vergib einen internen Namen, damit du den Chatbot leicht wiedererkennst.
  • Lege im Tab „Verhalten“ fest, ob der Chatbot formell oder weniger formell antworten soll.
  • Hinterlege im Tab „Verhalten“ bei Bedarf zusätzliche Informationen in den Feldern „Firmenphilosophie / Grundlegende Anweisungen“ und „Zusätzliche Anweisungen / FAQ“.
  • Wähle im Tab „Modell“ das KI-Modell aus.
  • Den Regler „Temperature“ im Tab „Modell“ siehst du nur bei Modellen, die eine Temperatur unterstützen. Er ist ein Expertenwert. Bei allen anderen Modellen (zum Beispiel GPT-5 und neuer) steht dort ein Hinweis, die Antworten steuert dann die Denkstufe.
  • Speichere den Chatbot. Beim ersten Speichern werden die Daten erzeugt, danach automatisch jede Nacht neu.
  • Öffne Erweiterungen → Meine Erweiterungen, bei „ChatGPT – Umfassender KI-Shop-Assistent“ über das Menü „…“ → „Konfigurieren“. Schalte in der Karte „Assistentin Frontend“ für den passenden Verkaufskanal „Frontend-Assistent aktiv“ ein und wähle unter „Wählen Sie den Chat-Assistenten“ deinen Chatbot aus. Ohne diese beiden Einstellungen erscheint der Chatbot nicht im Shop.
  • 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 findest du unter Einstellungen → Shop → Textbausteine.
    • Über das Suchfenster im Textbaustein-Set kannst du nach biloba.openAi.assistant-frontend suchen.
    • Dort findest du folgende Werte, die du anpassen kannst:
Frontend Assistent Textbausteine
Erstellen eines neuen Frontend Assistenten
Geändertes Farbdesign des Frontend Assistenten (Primärfarbe)
Geändertes Farbdesign des Frontend Assistenten

Automatische nächtliche Generierung deaktivieren (Test-/Klon-Shops)

Im Tab „Erweitert” des Chatbot-Bearbeiten-Formulars findest du den Schalter „Automatische nächtliche Generierung deaktivieren”. Ist er aktiv, wird die Wissensbasis dieses Chatbots nicht mehr jede Nacht automatisch neu erzeugt. Du kannst sie weiterhin manuell über „Daten neu generieren“ neu erzeugen.

Der Schalter ist vor allem für Test-, Staging- oder Klon-Shops gedacht, die sich einen OpenAI-Vektor-Speicher (Wissens-Index) mit dem Live-Shop teilen. Wird ein Shop geklont, kopiert Shopware häufig die komplette Assistenten-Konfiguration mit, inklusive der Vektor-Speicher-ID. Läuft die automatische nächtliche Generierung dann auf beiden Shops, überschreiben sie sich gegenseitig, und der Live-Chatbot kann veraltete oder falsche Inhalte ausgeben.

Ob das der Fall ist, erkennst du im Tab „Allgemein” des Bearbeiten-Formulars an einem gelben Warnhinweis, der erscheint, sobald der Vektor-Speicher mit mindestens einem weiteren Shop geteilt wird. Aktiviere in diesem Fall bei den Test-/Klon-Shops den Schalter im Tab „Erweitert” und verzichte dort zusätzlich auf eine manuelle Generierung. Den Chatbot im Klon einfach zu löschen, würde auch den gemeinsamen Speicher entfernen, der dann im Live-Shop fehlt. Willst du im Testsystem selbst testen, richte dort einen eigenen, unabhängigen Chatbot ein.

Produktbilder in Chat-Antworten anzeigen

Ab Version 5.21.0 (Shopware 6.7) bzw. 4.24.0 (Shopware 6.6) kann der Frontend-Chatbot bei Produktempfehlungen zusätzlich zum Link auch das Produkt-Hauptbild in seine Antwort einbinden.

Aktivieren kannst du das über den Schalter „Produktbilder in Antworten zeigen” im Tab „Darstellung” des Chatbot-Bearbeiten-Formulars. Standardmäßig ist die Option deaktiviert. Voraussetzung ist, dass die App auf die aktuelle Version aktualisiert ist.

Weitere Funktionen des Chatbots

Im Formular des Chatbots (Kataloge → Biloba AI – Chatbot, Chatbot bearbeiten) findest du außerdem:

  • Eigene Wissensdateien und URL-Quellen (Frontend Assistent Pro, auch in Premium): Im Tab „Wissensdateien“ wählst du eigene Dokumente aus der Medienverwaltung, zum Beispiel PDFs mit Größentabellen oder Montageanleitungen, oder fügst URLs hinzu. Jede Quelle braucht eine Beschreibung, damit der Chatbot weiß, wann er sie nutzt. Wie viele Dateien und Quellen möglich sind, steht in der Stufen-Tabelle unter „In-App Käufe“.
  • KI-Kennzeichnung (EU-KI-VO Art. 50): Im Tab „Verhalten“ steuerst du „KI-Badge im Chat-Header anzeigen“, „KI-Hinweiszeile im Chat anzeigen“ und „Haftungs-Guardrails aktiv“.
  • Avatar und Chat-Bubble: Im Tab „Darstellung“ ersetzt du auf Wunsch das Icon der geschlossenen Chat-Bubble durch einen Avatar, legst seine Position fest und stellst die Größe der geschlossenen Chat-Bubble ein (40 bis 200 Pixel). Direkt hochladen kannst du den Avatar ab Shopware 6.7, vorher wählst du ihn aus der Medienverwaltung.
  • Produktexport-Verkaufskanal: Standardmäßig legt der Chatbot in deinem Shop einen Produktvergleichs-Verkaufskanal „KI-Assistent Produktexport (Biloba)“ an und liest deine Produktdaten darüber deutlich effizienter aus. Mit dem Schalter „Produktexport-Verkaufskanal nicht automatisch einrichten“ im Tab „Erweitert“ verzichtest du darauf. Die Produktdaten werden dann einzeln über die Admin-API abgerufen.
  • Backend-Cache: Unser Backend speichert die App-Konfiguration (zum Beispiel API-Schlüssel und Modell-Einstellungen) bis zu 2 Minuten zwischen. Eine Änderung wirkt deshalb mit etwas Verzögerung. Sofort übernehmen kannst du sie unter Kataloge → Biloba AI – Daten & Logs im Tab „Backend-Cache“ mit „Backend-Cache leeren“.

Darstellung des Frontend-Assistenten anpassen

Ab Version 7.1.0 (Shopware 6.7) bzw. 6.1.0 (Shopware 6.6) kannst du Sichtbarkeit, Position und Farben des Chat-Widgets pro Verkaufskanal anpassen. Du findest die Einstellungen in der App-Konfiguration (Erweiterungen → Meine Erweiterungen, bei „ChatGPT – Umfassender KI-Shop-Assistent“ über das Menü „…“ → „Konfigurieren“) in der Karte „Assistentin Frontend“. Leere Felder verhalten sich wie bisher.

Sichtbarkeit und Verhalten

  • Sichtbarkeit Frontend Assistent: Legt fest, auf welchen Geräten der Assistent erscheint: „Desktop und mobil“, „Nur Desktop“, „Nur mobil“ oder „Ausgeblendet“. Die Grenze richtet sich nach der Breite des Browserfensters: mobil unter 768px, Desktop ab 768px.
  • Schließen-Kreuz an der Chat-Blase: Zeigt an der geschlossenen Chat-Blase ein X, mit dem Besucher den Assistenten selbst ausblenden können. „Aus“ ist die Standardeinstellung. Bei „Für diese Seitenansicht“ erscheint der Assistent nach dem Neuladen wieder, bei „Für die Browser-Sitzung“ bleibt er ausgeblendet, bis der Browser-Tab geschlossen wird.

Position und Ebene

  • Position Abstand unten mobil in px: Eigener Abstand der Chat-Blase vom unteren Rand auf mobilen Geräten (unter 768px). Bleibt das Feld leer oder steht dort 0, gilt der Wert aus „Position Abstand unten“.
  • z-index des Chat-Widgets: Bestimmt die Ebene von Chat-Blase und geöffnetem Chatfenster. Das hilft, wenn der Assistent von anderen Elementen im Shop überdeckt wird oder selbst darüber liegen soll. Ist das Feld leer, gilt der Standard (Blase unter dem Off-Canvas-Menü, geöffnetes Fenster 10000).

Farben

  • Textfarbe Header: Textfarbe der Kopfzeile des Chatfensters. Leer verwendet die Sekundärfarbe.
  • Hintergrundfarbe Frage-Boxen: Hintergrund der Schnellfragen. Leer verwendet Hellgrau (#f5f5f5).
  • Textfarbe Frage-Boxen: Textfarbe der Schnellfragen. Leer verwendet die Sekundärfarbe, ohne Sekundärfarbe die Hauptfarbe.
  • Hintergrundfarbe Chatfenster: Hintergrund des Chatfensters. Leer verwendet Weiß.
  • Hintergrundfarbe Nutzer-Nachrichten: Hintergrund der Nachrichten des Besuchers. Leer verwendet Hellgrau (#f5f5f5).

Konfigurierbare Fragen im Frontend-Assistenten

Im Chatfenster können bis zu 6 vordefinierte Schnellfragen als klickbare Vorschläge erscheinen. Du steuerst sie über die App-Konfiguration (Karte „Assistentin Frontend“) und die Textbausteine, nicht im Chatbot-Formular. Ab Werk sind Frage 1 bis 3 sichtbar und Frage 4 bis 6 ausgeblendet.

Frage anzeigen

Die Textbausteine question1 bis question6 sind ab Werk befüllt, du kannst die Texte anpassen. Eine Frage erscheint, wenn ihr Textbaustein einen Wert enthält und der Schalter „Frage N im Frontend ausblenden“ aus ist. Bei Frage 4 bis 6 ist dieser Schalter ab Werk eingeschaltet, dort reicht das Befüllen allein also nicht.

Frage ausblenden

Aktiviere den Schalter „Frage N im Frontend ausblenden” in der App-Konfiguration (assistantFrontendHideQuestion1 bis assistantFrontendHideQuestion6). Die Frage wird dann nicht mehr angezeigt, auch wenn der Textbaustein befüllt ist.

Wichtig (Shopware 6.6-Kompatibilität): Den Textbaustein zum Ausblenden nicht leeren. In Shopware 6.6 springt der Wert beim Speichern automatisch auf den Datei-Standard zurück und die Frage erscheint wieder. Verwende zum Ausblenden immer den Schalter, er funktioniert zuverlässig in allen unterstützten Shopware-Versionen.

Fragen zum aktuellen Produkt (Frontend Assistent Pro)

Pro-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Pro“ (in Premium enthalten). Ohne aktiven IAP steht sie nicht zur Verfügung.

Befindet sich der Kunde auf einer Produktseite, weiß der Chatbot automatisch, welches Produkt gerade angesehen wird. Fragen wie „Was kostet das?“ oder „Ich habe eine Frage zu diesem Produkt“ beantwortet er direkt zum richtigen Produkt, ohne dass der Kunde es noch einmal benennen muss. Wechselt der Kunde während des Chats die Seite, zieht der Produktbezug automatisch mit. Auf Variantenseiten kennt der Chatbot die gewählte Ausprägung. Allgemeine Fragen, etwa zu Versand oder Zahlung, beantwortet er auf Produktseiten wie gewohnt.

Zusätzlich erscheint auf Produktseiten eine eigene Schnellfrage „Kurz erklärt: [Produktname]“. Ein Klick genügt und die KI fasst das aktuelle Produkt verständlich zusammen. Die Funktion arbeitet sprachunabhängig.

Status prüfen

Im Admin findest du den Status beim Bearbeiten des Chatbots im Tab „Verhalten“ in der Karte „Produktseiten-Kontext“. Mit aktivem Frontend Assistent Pro steht dort „Aktiv“. Ohne Pro siehst du an dieser Stelle einen Kaufhinweis.

Schnellfrage ausblenden

Öffne Erweiterungen → Meine Erweiterungen, bei „ChatGPT – Umfassender KI-Shop-Assistent“ über das Menü „…“ → „Konfigurieren“ und gehe zur Karte „Assistentin Frontend“. Aktiviere dort den Schalter „Frage ‚Kurz erklärt‘ auf Produktseiten ausblenden“ (assistantFrontendHideProductQuestion). Die Schnellfrage verschwindet, der Produktbezug im Chat bleibt erhalten.

Texte anpassen

Gehe zu Einstellungen → Shop → Textbausteine und suche nach productQuestion. Zwei Textbausteine stehen zur Verfügung:

  • biloba.openAi.assistant-frontend.productQuestion: Beschriftung der Schnellfrage
  • biloba.openAi.assistant-frontend.productQuestionPrompt: Text, der beim Klick an den Chatbot gesendet wird

Der Platzhalter %productName% wird durch den Produktnamen ersetzt. Du kannst ihn auch weglassen.

Hinweis: Leerst du einen der beiden Textbausteine, wird die Schnellfrage ebenfalls ausgeblendet. Leere bei Bedarf danach den Cache. Zum Ausblenden ist der Schalter der sicherere Weg.

Mit Frontend Assistent Premium kann der Chatbot Preis, Verfügbarkeit und Lieferzeit live aus dem Shop abfragen, siehe „Live-Produktinfos im Chat“.

FAQ und „Jetzt fragen“-Link in eigenen Themes einbinden

Die App zeigt die Produkt-FAQ und den Link „Brauchen Sie Hilfe? Jetzt fragen!“ an den Stellen, die das Shopware-Standard-Theme vorsieht: die FAQ als eigenen Reiter oder unter der Beschreibung, den Link in der Kaufbox unter dem Warenkorb-Button. Baut dein Theme die Kaufbox oder die Produkt-Reiter komplett selbst auf, fehlen diese Stellen. FAQ und Link erscheinen dann nicht.

Für diesen Fall kann dein Theme-Entwickler beides mit je einer Zeile an einer beliebigen Stelle der Artikelseite einbinden:

Produkt-FAQ:

{% sw_include '@BilobaOpenAi/storefront/component/biloba-open-ai/faq-accordion.html.twig' ignore missing %}

„Jetzt fragen“-Link:

{% sw_include '@BilobaOpenAi/storefront/component/biloba-open-ai/help-link.html.twig' ignore missing %}
  • Die Dateinamen bleiben bei Updates der App gleich.
  • Angezeigt wird weiterhin nur, was in der App eingeschaltet ist: die FAQ bei aktivierter Produkt-FAQ und freigegebenen Einträgen in der Sprache der Seite, der Link mit Frontend Assistent Pro, eingeschaltetem Link und gestartetem Chat.
  • Die Einstellung zur Position der FAQ (Reiter oder unter der Beschreibung) gilt nur für die Standard-Stellen. Mit der Zeile bestimmt dein Theme die Position.
  • Der Link erscheint nur in der Kaufbox des Artikels, um den es auf der Seite geht. In einer Kaufbox mit einem anderen Artikel, zum Beispiel in einer Erlebniswelt, bleibt er ausgeblendet.
  • Verfügbar ab Version 7.10.0.

Chat-Aufbewahrung (DSGVO)

Im Chatbot-Formular legt das Feld „Chat-Aufbewahrung in Tagen” fest, wie lange die Chats gespeichert bleiben. Das Feld gilt nur mit dem In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten):

  • Leer oder 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).

Ohne Plus, Pro oder Premium werden Chats immer nach 7 Tagen gelöscht, egal welcher Wert eingetragen ist. Das gilt auch, wenn Plus abläuft: Nach einer Karenzzeit von 14 Tagen greifen wieder die 7 Tage.

Mit einem Chat werden auch die zugehörigen Einwilligungs-Protokolle gelöscht.

Auto-Kategorisierung der Chats (Frontend Assistent Plus)

Plus-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten). Ohne aktiven In-App-Kauf sind Schalter, 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 „Antwortqualität bewerten“ 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 „Chats“: neuer Filter “Kategorie” und neue Spalte “Kategorie” in der Chat-Liste
  • Die Kategorie wird zusätzlich in den CSV-Export geschrieben

Antwortqualität & Inhaltslücken (Frontend Assistent Plus)

Plus-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten). Ohne aktiven In-App-Kauf sind Schalter, 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 heißt perfekt getroffen, 0 heißt 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 Chatbot (Tab „Erweitert“):

  • Schalter „Antwortqualität bewerten“
  • „Schwellwert für niedrige Antwortqualität“ (Standard: 5). Chats mit einer Bewertung kleiner oder gleich diesem Wert gelten als schwach.

Im Tab „Chats“:

  • Die Spalte „Antwortqualität“ zeigt die Bewertung je Chat.
  • Der Filter „Nur niedrige Antwortqualität“ 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 Tab „Untersuchte Inhaltslücken“ des Moduls „Biloba AI – Chatbot“ (siehe Abschnitt „Untersuchte Inhaltslücken“).

Felder vom Produktexport ausschließen (Frontend Assistent Plus)

Plus-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten). Ohne aktiven In-App-Kauf siehst du an dieser Stelle einen Kaufhinweis. Deine Einstellungen bleiben gespeichert und greifen nach dem Kauf wieder.

Du kannst je Chatbot festlegen, welche Produktfelder der Chatbot nicht kennen soll. Das ist sinnvoll, wenn es zum selben Thema mehrere konkurrierende Angaben gibt, zum Beispiel mehrere Lieferzeit-Felder. Dann bleibt für den Chatbot genau eine gültige Aussage in der Wissensbasis.

So gehst du vor:

  1. Öffne den Chatbot und wechsle in den Tab „Erweitert”.
  2. Gehe zum Abschnitt „Produktexport: Felder ausschließen”.
  3. Aktiviere bei Bedarf „Lagerbestand ausschließen” und „Standard-Lieferzeit ausschließen”.
  4. Wähle in der Liste „Zusatzfelder ausschließen” alle Produkt-Zusatzfelder aus, die der Chatbot nicht kennen soll.
  5. Speichere den Chatbot.

Die Schalter im Detail:

  • Lagerbestand ausschließen: Der Bestand wird nicht in die Wissensbasis exportiert. Sinnvoll, wenn dein Shop die Verfügbarkeit über ein eigenes Zusatzfeld vorberechnet.
  • Standard-Lieferzeit ausschließen: Die Shopware-Lieferzeit wird nicht exportiert. Sinnvoll, wenn die maßgebliche Lieferzeit in einem Zusatzfeld steht und der Chatbot nicht zwei Angaben abwägen soll.
  • Mit Premium: Statt Lagerbestand und Lieferzeit auszuschließen, kannst du diese Werte auch live abfragen lassen (siehe „Live-Produktinfos im Chat“).
  • Zusatzfelder ausschließen: Checkbox-Liste aller Produkt-Zusatzfelder deines Shops. Sind im Shop keine Zusatzfelder für Produkte definiert, bleibt die Liste leer.

Wichtige Hinweise:

  • Der Ausschluss gilt für das Hauptprodukt und für alle Varianten.
  • Eine geänderte Auswahl wirkt ab der nächsten nächtlichen Aktualisierung des Chatbots. Beim ersten Mal können zwei Nächte vergehen, weil der Produktexport im Shop neu aufgebaut wird.
  • Produktdokumente aus Zusatzfeldern (Tab „Wissensdateien”) sind vom Ausschluss nicht betroffen.

Live-Produktinfos im Chat (Frontend Assistent Premium)

Premium-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Premium“.

Normalerweise nennt der Chatbot Preis, Verfügbarkeit und Lieferzeit aus der Wissensbasis. Die Wissensbasis wird nachts aktualisiert, die Werte können daher einen Tag alt sein. Mit den Live-Produktinfos fragt der Chatbot diese Werte im Moment der Frage direkt in deinem Shop ab.

Gästen zeigt der Chatbot, was sie in der Storefront sehen: im Verkaufskanal, in der Sprache und in der Währung der besuchten Seite. Angemeldeten Kunden nennt er ihren eigenen Preis, auch wenn er kunden- oder gruppenspezifisch ist (ab BilobaOpenAi 7.6.0 bzw. 6.6.0).

Voraussetzung: Für den Live-Abruf in Verkaufskanal, Sprache und Währung des Besuchers brauchst du BilobaOpenAi ab Version 7.5.0 (Shopware 6.7) bzw. 6.5.0 (Shopware 6.6). Mit älteren Versionen gibt es bei mehreren Verkaufskanälen mit derselben Domain keinen Live-Abruf. Fehlt die Mindestversion, weist dich der rote Banner oben in der Konfiguration darauf hin.

Live-Produktinfos aktivieren

  1. Öffne in der Konfiguration des Chatbots den Bereich „Live-Produktinfos“.
  2. Aktiviere den Schalter „Live-Produktinfos im Chat abfragen“.
  3. Wähle unter „Diese Werte darf der Chatbot live abfragen“ aus, was live abgefragt werden soll.
  4. Lege unter „Wann live abfragen?“ fest, wann der Chatbot abfragt.

Welche Werte werden live abgefragt?

  • Preis (inklusive Listenpreis und Staffelpreise)
  • Verfügbarkeit und Lieferzeit
  • Produkt-Zusatzfelder: höchstens 10. Die Felder müssen in Shopware unter „In Store-API verfügbar“ freigegeben sein. Sonst liefert der Shop keinen Wert.

Wann live abfragen?

  • Nur auf Nachfrage (Standard): Der Chatbot fragt live ab, wenn der Besucher nach einem Wert eines konkreten Artikels fragt.
  • Bei jedem Produktbezug: Der Chatbot fragt live ab, sobald die Antwort konkrete Artikel nennt. Das ist genauer, aber langsamer, braucht mehr Abrufe und verursacht höhere KI-Kosten.

Die Einstellung wirkt ab der nächsten Nachricht, auch in laufenden Chats.

Wenn der Shop nicht antwortet

Ist der Shop nicht erreichbar oder liefert er keinen Wert, antwortet der Chatbot aus der Wissensbasis. Der Besucher bekommt also immer eine Antwort, im Ausnahmefall mit dem Stand der letzten nächtlichen Aktualisierung.

Preisquelle für die nächtliche Wissensbasis

Unabhängig vom Live-Abruf kannst du festlegen, welchen Preis die nächtliche Wissensbasis enthält. Die Option „Store-API (Storefront-Preis, Premium)“ übernimmt den Preis, den ein Gast im Shop sieht.

Hinweis: Fehlt bei einigen Produkten der Preis, hat der Shop für sie keinen Storefront-Preis geliefert. Prüfe, ob die Produkte im Verkaufskanal sichtbar sind, und starte die Erstellung erneut.

Bestellauskunft im Chat (Frontend Assistent Premium)

Premium-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Premium“.

Der Chatbot beantwortet Fragen zum Stand einer Bestellung: Bestellstatus, Zahlungsstatus und Versandstatus samt Sendungsnummer.

  • Angemeldete Kunden fragen einfach nach ihrer Bestellung und bekommen Auskunft zu ihren eigenen Bestellungen.
  • Gäste nennen Bestellnummer und E-Mail-Adresse der Bestellung oder melden sich über den Link im Chat an. Der Chat läuft nach der Anmeldung weiter. Fehlversuche sind begrenzt.

Aktivieren: Schalte in der Konfiguration des Chatbots im Bereich „Bestellauskunft“ den Schalter „Bestellauskunft im Chat anbieten“ ein. Ab Werk ist er aus.

Voraussetzung: BilobaOpenAi ab 7.6.0 (Shopware 6.7) bzw. 6.6.0 (Shopware 6.6). Beim Update bestätigst du im Shopware-Admin die erweiterten App-Rechte (Kunden und Bestellungen lesen). Ohne Update und Bestätigung gibt es die Auskunft nur für Gäste mit Bestellnummer und E-Mail-Adresse.

Ü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

  • Titel generieren und Alt-Text generieren: legen fest, welche Bild-META-Informationen in der Massenbearbeitung und beim Hochladen erzeugt werden.
  • Ob Bildtexte beim Hochladen automatisch entstehen und in welchen Sprachen, stellst du auf der Automatik-Seite ein (siehe „Bildtexte beim Hochladen“).
  • Beim Hochladen fehlt noch der Produktkontext. Sollen die Bildtexte den Produktkontext nutzen, speichere den Artikel vorher mit dem gewünschten Bild.
  • Ausnahme Shopware 6.5: Dort stehen die Felder „Automatische Generierung ausgewählter META-Informationen beim Erstellen oder Aktualisieren von Bildern“ und „Auswahl der zu generierenden Sprachen“ noch in dieser Karte.
  • Ist dein Shop per Htaccess geschützt, trage die Zugangsdaten in der Karte „Allgemeine Einstellungen“ ein (Htaccess Anmeldename und Htaccess-Passwort). Das ist nötig, weil die KI die Bilder abruft und analysiert.

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.
  • Temperatur (Experteneinstellung): gibt an, wie zufällig die Antworten der KI sind. GPT-5 und alle neueren OpenAI-Modelle unterstützen keine Temperatur, dort wirkt der Wert nicht.
  • TopP (Experteneinstellung): eine alternative Sampling-Methode zur Temperatur. Ist eine Temperatur gesetzt, wird TopP nicht verwendet.

Produkt-FAQ

Produkt-FAQ

Mit der Produkt-FAQ zeigst du auf der Produktseite häufige Fragen und Antworten zu genau diesem Artikel. Du schreibst sie selbst oder lässt die KI Entwürfe aus den Produktdaten erzeugen.

Voraussetzung: All-in-One KI Shop Assistent ab Version 7.8.0 (Shopware 6.7). Die Produkt-FAQ und die allgemeinen Einträge brauchen keinen In-App-Kauf.

Fragen pflegen: Du findest die Fragen am Produkt im Reiter „FAQ“. Über „Neue Frage“ schreibst du selbst eine Frage, über „Per KI erzeugen“ schreibt die KI Entwürfe. Von der KI erzeugte Texte sind zuerst Entwürfe: Lies sie durch und gib sie frei. Im Shop erscheinen nur freigegebene und aktive Fragen.

Reiter „FAQ“ am Produkt mit den allgemeinen Fragen, die für das Produkt gelten
Reiter „FAQ“ am Produkt mit den allgemeinen Fragen, die für das Produkt gelten

Varianten: Hat eine Variante keine eigenen Fragen, zeigt sie die Fragen des Hauptartikels. Legst du an der Variante eine Frage an, führt sie ab dann eigene Einträge.

Einstellungen: In der Konfiguration der Erweiterung findest du den Bereich „FAQ auf der Produktseite“.

  • Produkt-FAQ im Shop anzeigen: schaltet die Anzeige im Shop ein.
  • Platzierung auf der Produktseite: eigener Reiter neben Beschreibung und Bewertungen oder unter der Produktbeschreibung.
  • Erste Frage geöffnet anzeigen: Die erste Antwort ist beim Laden der Seite schon sichtbar.
  • Höchstzahl der Fragen je Produkt: 1 bis 20, voreingestellt sind 6. Der Wert begrenzt auch, wie viele Entwürfe die KI je Durchlauf schreibt.
  • Zusatzfelder, aus denen die KI Fragen ableiten darf: zum Beispiel Zertifizierungen oder Gewebe. Ihre Werte gehen zusammen mit der Beschreibung an die KI.
FAQ im Shop als eigener Reiter
FAQ im Shop als eigener Reiter
FAQ im Shop unter der Produktbeschreibung
FAQ im Shop unter der Produktbeschreibung

Allgemeine FAQ-Einträge für alle Produkte, Hersteller oder Kategorien

Manche Fragen betreffen nicht nur einen Artikel, zum Beispiel zu Versand, Pflege oder Garantie einer Marke. Solche Fragen legst du einmal als allgemeinen Eintrag an, die Produktseiten zeigen sie automatisch.

Anlegen: Öffne unter Kataloge das Modul „Biloba AI – FAQ“, Reiter „Produkt-FAQ“, Ansicht „Allgemeine Einträge“, und klicke auf „Allgemeinen Eintrag anlegen“. Unter „Gilt für“ wählst du:

  • Alle Produkte: Der Eintrag erscheint bei jedem Produkt des Shops.
  • Hersteller: Der Eintrag erscheint bei den Produkten der gewählten Hersteller.
  • Kategorien: Der Eintrag erscheint bei den Produkten der gewählten Kategorien, auch in deren Unterkategorien.
FAQ-Modul mit der Ansicht „Allgemeine Einträge“
FAQ-Modul mit der Ansicht „Allgemeine Einträge“
Neuer allgemeiner Eintrag mit der Auswahl „Gilt für“
Neuer allgemeiner Eintrag mit der Auswahl „Gilt für“

Pro Shop sind höchstens 50 allgemeine Einträge möglich. Freigabe und Sprachen funktionieren wie bei den Fragen am Produkt: Von der KI erzeugte Texte starten als Entwurf.

Reihenfolge auf der Produktseite: Zuerst die Fragen des Produkts, dann die Einträge seiner Kategorien, dann die seines Herstellers, dann die für alle Produkte. Stellt ein späterer Eintrag dieselbe Frage noch einmal, erscheint sie nur einmal.

Am Produkt: Im Reiter „FAQ“ des Produkts siehst du unter „Allgemeine Fragen, die für dieses Produkt gelten“, welche allgemeinen Einträge dort erscheinen. Bearbeiten kannst du sie über „Im FAQ-Modul bearbeiten“. Löschst du einen allgemeinen Eintrag, verschwindet er bei allen Produkten, für die er gilt.

FAQ als Element in Erlebniswelten

Mit dem Element „FAQ“ zeigst du FAQ-Einträge auf jeder Seite einer Erlebniswelt, also auch auf Kategorie- oder Landingpages.

  1. Füge in der Erlebniswelt den Block „FAQ“ ein.
  2. Wähle in den Einstellungen des Elements die „Quelle“:
    • Allgemeine Einträge: Mit „Automatisch nach Seite“ zeigt das Element auf einer Produktseite die allgemeinen Einträge, die für das Produkt gelten, auf einer Kategorieseite die für diese Kategorie und für alle Produkte, auf jeder anderen Seite die für alle Produkte. Mit „Selbst wählen“ legst du fest, ob es die Einträge für alle Produkte, für bestimmte Hersteller oder für bestimmte Kategorien zeigt.
    • Einträge eines Produkts: die Fragen eines gewählten Produkts samt den allgemeinen Einträgen, die dafür gelten. Ohne gewähltes Produkt gilt auf einer Produktseite das Produkt der Seite.
    • Chatbot-FAQ (Plus): die Fragen eines gewählten Chatbots.
  3. Speichere das Layout.
Einstellungen des Elements „FAQ“ in der Erlebniswelt
Einstellungen des Elements „FAQ“ in der Erlebniswelt

Es erscheinen nur aktive, freigegebene Einträge.

Neues Recht beim Update: Für dieses Element braucht die Erweiterung einen Schreibzugriff auf Erlebniswelten, den du beim Update bestätigst. Wir nutzen ihn nur, damit dein Shop eine Seite neu aufbaut, wenn sich die FAQ ändert. Deine Layouts bleiben, wie sie sind.

Fehlende FAQ-Einträge wiederherstellen

Die Fragen liegen in deinem Shop, zusätzlich halten wir eine Kopie im Backend. Über „Wiederherstellen“ siehst du Einträge, die in unserer Kopie sind, aber in deinem Shop fehlen, zum Beispiel nach einer Deinstallation ohne „Daten behalten“ oder weil jemand sie gelöscht hat.

  • Wiederherstellen: Die Einträge kommen nur auf deinen Klick zurück, von uns aus stellen wir nichts wieder her.
  • Endgültig verwerfen: Der Eintrag verschwindet aus unserer Kopie und lässt sich danach nicht mehr wiederherstellen.
Fenster „Wiederherstellen“ mit den fehlenden Einträgen
Fenster „Wiederherstellen“ mit den fehlenden Einträgen

Das sichert die Sicherung nicht: Gesichert ist der Stand, den wir zuletzt gesehen haben. Änderungen über die Erweiterung sichern wir sofort. Änderst du einen Eintrag direkt im Shop, an der Erweiterung vorbei, zum Beispiel per Import oder API, sehen wir das erst beim nächsten Abgleich. Der läuft, wenn du den Reiter „FAQ“ öffnest und ein Abgleich fällig ist, nicht regelmäßig im Hintergrund. Wurde ein Eintrag direkt im Shop geändert und danach gelöscht, ohne dass ein Abgleich dazwischen lag, stellen wir den älteren Stand wieder her.

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.
  • Ist noch keine Beschreibung vorhanden, trage bitte einen kurzen Text ein (empfohlen sind 50 bis 1000 Zeichen). Er 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 in Zusatzfelder (Custom Fields) auf Produkt- und Kategorieseite (PromptPlus)

PromptPlus-Funktion: Diese Funktion erfordert den In-App-Kauf „PromptPlus“. Ohne aktives PromptPlus zeigt die Box statt der Generierung den Hinweis „PromptPlus erforderlich“.

Auf der Produkt- und Kategorieseite steht im Tab „Freitextfelder” die Box „Zusatzfelder per KI füllen“ zur Verfügung. Du wählst ein textfähiges Custom Field aus und klickst auf „Inhalt generieren“. Über die Massenbearbeitung lassen sich Custom Fields auch für mehrere Produkte oder Kategorien gleichzeitig befüllen (Bereich „Produkt Zusatzfeld“ bzw. „Kategorie Zusatzfeld“ in der Massenbearbeitung, PromptPlus):

  • 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 Produkt- oder Kategorieseite gepflegt werden.

Kategorie Beschreibung

  • Gehe zu Kataloge -> Kategorien und wähle deine gewünschte Kategorie aus.
  • Ist bereits eine Kategoriebeschreibung vorhanden, werden sie und der Kategoriename genommen.
  • Ist noch keine Beschreibung vorhanden, trage bitte einen kurzen Text ein (empfohlen sind 50 bis 1000 Zeichen). Er 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 → Biloba AI – Massenbearbeitung.
  • in “Bereich” kann der gewünschte Bereich ausgewählt werden, der bearbeitet werden soll.
    • Produktbeschreibung
    • Produkt-META-Informationen
    • Produkt Zusatzfeld (PromptPlus)
    • Bild-Alt- und Titel-Text
    • Kategoriebeschreibung
    • Kategorie-META-Informationen
    • Kategorie Zusatzfeld (PromptPlus)
  • Einzelne Einstellungen für die verschiedenen Bereiche sind vorhanden
  • Filter grenzen die Auswahl ein: „Bisher nicht von der KI bearbeitet“, „Nur leere Felder befüllen“, „Kindartikel von Variantenartikeln zusätzlich generieren“ sowie Artikelstatus und Lagerbestand.
  • Sprachen gibt an, welche Sprache bearbeitet werden soll.
  • Kategorien, Hersteller und Medienordner grenzen die zu bearbeitenden Einträge ein. Mehrfachauswahl und Auswahl rückgängig machen mit Strg + Klick (Cmd + Klick bei macOS).
  • Weiter folgend die gefundenen Entitäten, welche bearbeitet werden.
  • Im Bereich „Aktuell laufende Massenbearbeitungen“ siehst du, ob gerade ein Job läuft.
Auswahl der vorhanden Bereiche

Neu über den Listen für Kategorien und Hersteller: ein Suchfeld, mit dem du den passenden Eintrag schneller findest.

Biloba AI Massenbearbeitung mit Hinweis zur Automatik und Suchfeld
Massenbearbeitung: der Hinweis „Zur Automatik” führt direkt zur Automatik-Seite. Neu ist das Suchfeld über Kategorien und Herstellern.

Automatik

Mit der Automatik erzeugt Open AI Texte für neu angelegte Produkte und Kategorien im Hintergrund und setzt sie direkt ein. So musst du bei jedem neuen Datensatz nicht mehr von Hand nachhelfen. Deinen bestehenden Bestand bearbeitest du weiterhin über die Massenbearbeitung.

Du findest die Automatik als eigenen Eintrag „Biloba AI Automatik” im Shopware-Admin. Von der Prompts-Seite und aus der Massenbearbeitung führt jeweils ein Link direkt dorthin.

Die Text-Automatik gehört zu PromptPlus (In-App-Kauf). Die Bildtexte beim Hochladen (Titel und Alt-Text) erzeugt die Erweiterung dagegen auch ohne PromptPlus.

Biloba AI Automatik Einstellungsseite im Shopware-Admin
Die Automatik-Seite „Biloba AI Automatik”: links die Bereiche, rechts je Bereich Sprachen, Prüfintervall, Wartezeit und Filter.

Bereiche

Für welche Inhalte die Automatik Texte erzeugt, hängt von der Erweiterung ab. In Open AI stehen folgende Bereiche zur Verfügung:

  • Produkte – Beschreibung
  • Produkte – Meta-Daten
  • Produkte – Zusatzfeld
  • Kategorien – Beschreibung
  • Kategorien – Meta-Daten
  • Kategorien – Zusatzfeld
  • Bilder – Texte beim Hochladen

Jeden Bereich aktivierst und konfigurierst du einzeln.

Einstellungen je Bereich

Für jeden Bereich legst du fest, wie die Automatik arbeiten soll:

  • Sprachen: Je Sprache richtest du eine eigene Automatik ein. Mehrere Sprachen wählst du gemeinsam aus.
  • Prüfen alle: Wie oft die Automatik nach neuen Einträgen sucht (1, 3, 6 oder 24 Stunden, Standard 3 Stunden).
  • Wartezeit nach dem Anlegen (in Minuten): Sinnvoll bei Importen, die einen Datensatz zuerst leer anlegen und erst danach befüllen. Die Automatik wartet die eingestellte Zeit ab, bevor sie einen neuen Eintrag bearbeitet.
  • Umgang mit dem Text (je nach Bereich): einsetzen bzw. vorhandenen Text ersetzen, nur als Vorschlag hinterlegen, oder vor bzw. hinter den vorhandenen Text schreiben.
  • Nur leere Felder befüllen: Vorhandene Inhalte bleiben unangetastet, die Automatik ergänzt nur, was noch fehlt.
  • Filter nach Kategorien und Herstellern (optional): Grenzt ein, für welche Datensätze die Automatik läuft. Die Filter gelten zum Zeitpunkt der Prüfung nach der Wartezeit, eine später zugeordnete Kategorie wird nicht nachgeholt.

Status und automatisches Pausieren

Für jeden Bereich siehst du auf einen Blick, ob die Automatik aktiv oder inaktiv ist oder gerade ein Lauf läuft. Dazu zeigt die Übersicht den letzten Lauf und die nächste Prüfung an.

Ist dein Shop einmal nicht erreichbar oder lehnt der KI-Anbieter ab (zum Beispiel bei fehlendem Guthaben oder einem ungültigen API-Schlüssel), pausiert die Automatik von selbst. Sobald es wieder passt, nimmt sie den Betrieb automatisch wieder auf.

Bildtexte beim Hochladen (ohne PromptPlus)

Die Bildtexte beim Hochladen (Titel und Alt-Text) erzeugt Open AI weiterhin ohne PromptPlus. Die zugehörigen Einstellungen sind von der App-Konfiguration auf die Automatik-Seite umgezogen. Die alten Felder in der App-Konfiguration haben damit keine Wirkung mehr, maßgeblich sind jetzt die Einstellungen auf der Automatik-Seite.

Hinweis beim Aktivieren

Beim Aktivieren blendet die Erweiterung einen Hinweis ein: Für jeden erzeugten Text fallen Tokens und damit Kosten beim KI-Anbieter an. Die Texte werden ohne inhaltliche Kontrolle eingesetzt, die Nutzung erfolgt auf eigenes Risiko. Prüfe die erzeugten Inhalte deshalb regelmäßig.

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:

  1. Über die Einstellungen: Navigiere zu Einstellungen → Erweiterungen → Biloba AI Prompts.
  2. Über die Massenbearbeitung: Im Modul „Biloba AI – Massenbearbeitung“ findest du einen Link “Prompts konfigurieren” direkt in der Konfigurationsansicht.

Verfügbare Bereiche

In dieser App stehen dir 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
  • ##keywordsAmount##: 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.
  • ##productDeliveryTime##: Lieferzeit des Produkts
  • ##metaTitle## / ##metaDescription##: vorhandener Meta-Titel bzw. vorhandene Meta-Beschreibung als Kontext
  • ##maxLength##: maximale Zeichenlänge, zum Beispiel bei META-Informationen und Bildtexten
  • ##customFieldName## / ##customFieldLabel##: technischer Name bzw. Bezeichnung des Zusatzfelds, das befüllt wird (PromptPlus)
  • ##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

  • Je Prompt-Typ wählst du das KI-Modell für die Textgenerierung aus. Zur Auswahl stehen aktuelle Modelle von OpenAI, Claude, Gemini und Mistral.
  • Standard ist GPT-6.1 Sol. Welche Modelle es gerade gibt, siehst du direkt in der Auswahl.
  • Die Modelle unterscheiden sich in Qualität, Geschwindigkeit und Kosten. Für große Mengen eignen sich die kleineren, günstigeren Varianten.

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 du die komplette Kontrolle übernehmen willst. Bitte nur aktivieren, wenn du mit Prompting vertraut bist.
  • Der aktuelle System-Prompt wird zur Transparenz angezeigt.

5. Toggle-Einstellungen

  • In den Prompt-Einstellungen (Einstellungen → Erweiterungen → Biloba AI Prompts) gibt es pro Prompt-Typ Schalter 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.
  • Keywords verwenden: fügt vorhandene Keywords aus Produkt bzw. Kategorie und aus der App-Konfiguration dem Prompt hinzu.
  • Produktkontext einbeziehen (Bild-META-Informationen): nutzt bei der Bildanalyse die verknüpften Produktinformationen, wenn vorhanden.
  • Standardmäßig sind die drei Schalter für Eigenschaften, Kategorien und Bild-Informationen 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

  1. Sei spezifisch: Je genauer deine Anweisungen, desto besser das Ergebnis.
  2. Nutze Variablen: Verwende die verfügbaren Variablen für dynamische Inhalte.
  3. Teste schrittweise: Beginne mit kleinen Änderungen und teste die Ergebnisse.
  4. Beispiele sind hilfreich: Gebe der KI Beispiele für den gewünschten Stil.
  5. 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.

Das hilft dir, deine 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 (PromptPlus)

PromptPlus-Funktion: Variablen werden nur bei aktivem PromptPlus 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 aktives PromptPlus werden die Platzhalter vor dem Generieren aus dem Prompt entfernt. Im generierten Text tauchen sie also nicht auf.

Biloba AI – Daten & Logs

Das Modul „Biloba AI – Daten & Logs“ notiert jeden Job, der für die entsprechenden Bereiche gelaufen ist. Wenn ein Job nicht durchläuft, ist der Log die erste Anlaufstelle.

Gehe zu Kataloge → Biloba AI – Daten & Logs.

Generierungs Log

Hier werden die einzelnen Entitäten eingetragen, welche von der KI bearbeitet werden und nach Bereichen sortiert.

Massenbearbeitung Log

Hier werden die Jobs der Massenbearbeitung eingetragen.

Chats

Die Chats und die folgenden Tabs findest du nicht in „Daten & Logs“, sondern im Modul Kataloge → Biloba AI – Chatbot: „Chats“, „Gespeicherte FAQs“, „Untersuchte Inhaltslücken“ und „Einwilligungs-Protokoll“.

Im Tab „Chats“ werden die Nachrichten der Kunden mit dem Chatbot eingetragen. In der Detailansicht siehst du, wie der Chatbot darauf reagiert hat.

Detailansicht der Nachrichten zwischen Kunde und Frontend Assistent

Häufige Fehler 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 „Chats“ lädst du die Chat-Verläufe als CSV herunter (Plus-Funktion). Die Datei enthält eine Zeile pro Chat mit den Spalten chat_updated_at, sales_channel_id, assistant_name, thread_id, conversation und category, getrennt durch Semikolon. In der Spalte conversation steht der ganze Verlauf, die einzelnen Nachrichten sind durch --- getrennt. Gesetzte Filter (Zeitraum, Verkaufskanal, Kategorie) gelten auch für den Export.

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 Tab „Chats“) 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 findest du unter Kataloge → „Biloba AI – FAQ“ im Reiter „Chatbot-FAQ“ (siehe unten). Aktive FAQs fließen in die Wissensbasis des Chatbots ein, aus dessen Chat sie erstellt wurden. Neue, geänderte und gelöschte Einträge übernimmt der Chatbot beim nächsten Neuaufbau der Wissensbasis: nachts automatisch (sofern die nächtliche Generierung für diesen Chatbot nicht deaktiviert ist), sonst über „Daten neu generieren“.

Gespeicherte FAQs

Ab Version 7.8.0 pflegst du die Chatbot-FAQ zentral unter Kataloge → „Biloba AI – FAQ“ im Reiter „Chatbot-FAQ“. Der Tab „Gespeicherte FAQs“ im Chatbot-Modul zeigt nur noch einen Hinweis und den Button „Biloba AI – FAQ öffnen“.

Im Reiter „Chatbot-FAQ“ verwaltest du alle per „FAQ aus Chat erstellen“ oder über „Neue FAQ“ angelegten Einträge. Pro Eintrag siehst du Frage, Antwort, Chatbot und Erstellungsdatum, über die Suche findest du Einträge nach Frage oder Antwort, über den Filter die Einträge eines Chatbots. Einträge lassen sich bearbeiten und löschen. Über den Schalter „Aktiv“ legst du fest, ob ein Eintrag in den Chatbot einfließt. Neue Einträge sind aktiv. Die Chatbot-FAQ ist Teil des In-App-Kaufs „Frontend Assistent Plus“ (auch in Pro und Premium enthalten).

Untersuchte Inhaltslücken (Frontend Assistent Plus)

Plus-Funktion: Diese Funktion erfordert den In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten).

Im Tab „Untersuchte Inhaltslücken“ findest du alle Auswertungen, die du über den Button „Inhaltslücken auswerten“ im Tab „Chats“ 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.

Du verwaltest die Server unter Einstellungen → Erweiterungen → Biloba AI MCP Servers.

Wichtig: MCP-Tools werden nur von GPT-5 und neueren Modellen unterstützt. Der Server muss öffentlich erreichbar sein, private oder lokale Adressen (zum Beispiel localhost oder interne Netze) werden abgelehnt.

Server hinzufügen

Um einen neuen MCP-Server hinzuzufügen:

  1. Klicke auf “Server hinzufügen”
  2. Gib einen Namen für den Server ein (z.B. “SEO Keywords”)
  3. Wähle den Server-Typ aus der Liste
  4. Trage die erforderlichen Zugangsdaten ein (API-Key, URL, etc.)
  5. Speichere die Konfiguration

Server testen

Nach dem Speichern kannst du die Verbindung testen:

  1. Klicke auf das Test-Symbol neben dem Server
  2. Der Server wird kontaktiert und die verfügbaren Tools werden abgerufen
  3. Bei erfolgreicher Verbindung siehst du eine Bestätigung

Server mit Prompts verknüpfen

Damit ein MCP-Server bei der Textgenerierung verwendet wird:

  1. Gehe zu den Prompt-Einstellungen
  2. Wähle den gewünschten Prompt-Typ (z.B. “Produkt Beschreibung”)
  3. Im Abschnitt “MCP-Server” wähle die Server aus, die verwendet werden sollen
  4. 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

Stufen des Chatbots: Es gibt die In-App-Käufe „Frontend Assistent Plus“, „Frontend Assistent Pro“ und „Frontend Assistent Premium“. Jede höhere Stufe enthält alle Funktionen der niedrigeren.

Ohne KaufPlusProPremium
Chatbots3515unbegrenzt
Wissensdateien je Chatbotkeinekeine50500
Speicher für Wissensdateienkeinerkeiner250 MB1 GB
URL-Quellen je Chatbotkeinekeine550
Produktzeilen in der Wissensbasis90.00090.000250.000600.000

Nur mit Premium: Live-Produktinfos im Chat (Preis, Verfügbarkeit, Zusatzfelder live aus dem Shop), die Bestellauskunft im Chat und die Preisquelle „Store-API (Storefront-Preis)“ für die Wissensbasis.

Was ist PromptPlus?

PromptPlus ist ein optionaler In-App-Kauf, der erweiterte Funktionen für deine KI-Textgenerierung freischaltet: die Automatik für neue Einträge, Zusatzfelder per KI füllen, die Anbindung von MCP-Servern und zusätzliche Prompt-Variablen aus Custom Fields.

Enthaltene Funktionen

  • Automatik: Texte für neu angelegte Produkte und Kategorien im Hintergrund erzeugen
  • Zusatzfelder per KI füllen: KI-Texte für textfähige Custom Fields, einzeln und in der Massenbearbeitung
  • Custom Fields als Prompt-Variablen: Werte aus Zusatzfeldern im Prompt verwenden
  • 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

  1. Der Kauf erfolgt direkt über den Shopware Store
  2. Nach dem Kauf wird das Feature automatisch aktiviert
  3. Du siehst den Status in der “In-App Käufe” Übersicht im Log-Bereich

Abonnement-Informationen

  • PromptPlus ist ein Abonnement über den Shopware Store, Preis und Laufzeit findest du dort
  • 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 Plus-Funktion und erfordert den In-App-Kauf „Frontend Assistent Plus“ (auch in Pro und Premium enthalten).

So erwirbst du den In-App-Kauf

  1. Gehe zu Kataloge → Biloba AI – Chatbot
  2. Öffne den Tab „Einwilligungs-Protokoll“
  3. Dort siehst du einen Hinweis „Frontend Assistent Plus“
  4. Klicke auf „Jetzt freischalten“, es öffnet sich der Shopware In-App-Kauf-Dialog
  5. 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:

  1. Gehe zu Kataloge → Biloba AI – Chatbot
  2. Bearbeite den gewünschten Chatbot
  3. Aktiviere im Tab „Erweitert“ den Schalter „DSGVO-Einwilligungen protokollieren“
  4. 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 Chatbot eingeschaltet sein

Was wird protokolliert?

Wenn ein Storefront-Besucher den Einwilligungsdialog des Chatbots akzeptiert, werden folgende Daten erfasst:

  • Zeitstempel: Datum und Uhrzeit der Einwilligung
  • Chat-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:

  1. Öffne den KI-Shop-Assistenten
  2. Navigiere zum Tab “Logging”
  3. Wähle den Unter-Tab “DSGVO-Einwilligungen” aus

Tabellenansicht

Die Log-Übersicht zeigt dir folgende Spalten:

  • Zeitstempel: Datum und Uhrzeit der Einwilligung
  • Chat-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)

Chat-Detail (Klick auf die Chat-ID):

  • Vollständiger Chat-Verlauf der Konversation
  • Chat-ID (kopierbar)
  • Letztes Aktualisierungsdatum
  • Hinweis, falls der Thread bereits gelöscht wurde

CSV-Export

Du kannst die Einwilligungs-Logs als CSV-Datei exportieren:

  1. Klicke im Tab “DSGVO-Einwilligungen” auf den Export-Button
  2. 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

Einwilligungs-Logs werden zusammen mit dem zugehörigen Chat gelöscht, sobald dessen Aufbewahrungsfrist abgelaufen ist (siehe „Chat-Aufbewahrung (DSGVO)“). Wenn dein Shop aus dem System entfernt wird (z.B. bei Deinstallation der App), werden alle zugehörigen Einwilligungs-Logs sofort gelöscht. Es verbleiben keine Daten im System.


Zusammenfassung des Ablaufs

  1. Storefront-Besucher öffnet den Chatbot
  2. Einwilligungsdialog wird angezeigt
  3. Besucher klickt “Akzeptieren”
  4. Einwilligung wird pseudonymisiert auf dem Server protokolliert (nur wenn IAP aktiv UND Protokollierung eingeschaltet)
  5. Besucher startet Chat → Chat-ID wird nachträglich dem Log-Eintrag zugeordnet
  6. Du kannst die Logs im Admin einsehen, filtern und als CSV exportieren

Rechtliche Hinweise für Betreiber

Als Shop-Betreiber haftest du für Aussagen deines KI-Chatbots wie für eigene geschäftliche Handlungen (z.B. bei Produkt-, Preis- oder Verfügbarkeitsauskünften). Ein Restrisiko durch Fehlantworten lässt sich technisch nicht vollständig ausschließen, aber deutlich senken:

  • Chat regelmäßig testen: Prüfe in unregelmäßigen Abständen selbst, wie der Assistent auf typische Kundenfragen antwortet, besonders nach Sortiments- oder Prompt-Änderungen.
  • Chat-Analyse und FAQ-Kuration nutzen (Frontend Assistent Plus): Die Bewertung der Antwortqualität und die Auswertung der Inhaltslücken zeigen dir schwach beantwortete Themen früh. Über „FAQ aus Chat erstellen“ pflegst du erkannte Lücken direkt nach.
  • Sensible Kategorien und Landingpages ausblenden: In der App-Konfiguration (Karte „Assistentin Frontend“) kannst du den Frontend-Assistenten gezielt für einzelne Kategorien oder Landingpages deaktivieren, z.B. bei sensiblen Themen wie Gesundheit oder Rezeptpflicht.
  • Datenschutzerklärung prüfen: Kläre mit deinem Datenschutzbeauftragten bzw. Anwalt, ob ein Hinweis zum Einsatz des KI-Chatbots ergänzt werden muss. Fertige Rechtstexte können wir dir nicht liefern, das ist Anwaltssache.

Diese Hinweise ersetzen keine Rechtsberatung.


FAQs

KI Shop-Assistent: Allgemeine Fragen

Das kann mehrere Ursachen haben:

  1. Ein bereits installiertes Plugin hat einen falschen Datenbanktypen verwendet: https://forum.shopware.com/t/unknown-database-type-enum-requested/98651
  2. Du kannst in deiner Shopware-Konfiguration einmal Folgendes einfügen: https://symfony.com/doc/current/doctrine/dbal.html#registering-custom-mapping-types-in-the-schematool

Dieser Fehler kommt nicht von unserer App, sondern von Shopware selbst. Einige Hoster (darunter Profihost) setzen weiterhin auf die ältere Bibliothek OpenSSL 1.1.1, die von neueren Shopware-Versionen nicht mehr unterstützt wird. Dadurch können die verschlüsselten Verbindungen, die für KI-Aufrufe nötig sind, fehlschlagen.

Shopware hat dafür einen Patch nachgeliefert, der ab Version 6.7.4.0 enthalten ist. So löst du das Problem:

  1. Aktualisiere Shopware auf mindestens Version 6.7.4.0.
  2. Alternativ oder ergänzend: Bitte deinen Hoster, eine aktuelle OpenSSL-Version (3.x) bereitzustellen.

Danach funktionieren die KI-Aufrufe wieder wie gewohnt. Bei Fragen helfen wir gerne weiter (Kontaktformular).

Bitte stelle sicher, dass auf dem API-Schlüssel Guthaben hinterlegt ist.

In diesem Fall wurde die Anwendung nicht korrekt installiert. Meistens tritt dies in Verbindung mit anderen Plugins auf, die einen Fehler in deiner Datenbankkonfiguration verursachen. Wenn du unsere App deinstallierst, solltest du eine Fehlermeldung von der Datenbank erhalten, die einen Hinweis darauf gibt, welches Plugin den Fehler verursacht hat. Wenn du die Fehlermeldung nicht interpretieren kannst, sag uns bitte Bescheid. (Kontaktformular).

Für die Testphase sind 50 KI-Aufrufe freigeschaltet. Falls du die App nach der Testphase weiter nutzen möchtest, melde dich gerne bei uns. (Kontaktformular)

So konfigurierst du die App:

1. Lade die App in der Administration unter „Erweiterungen → Meine Erweiterungen“ hoch.

2. Installiere und aktiviere die App.

3. Öffne die Konfiguration der App und trage den API-Schlüssel deines KI-Anbieters ein. Für den Chatbot brauchst du einen OpenAI-API-Schlüssel.

4. Wähle das KI-Modell je Prompt-Typ unter Einstellungen → Erweiterungen → Biloba AI Prompts und je Chatbot im Tab „Modell“.

5. In der Karte „Einstellungen “Alle META-Tags Produkt / Kategorie (konfiguriert)”“ legst du fest, welche Metadaten erzeugt werden sollen. Diese Option ist für die Massenbearbeitung vorgesehen.

Die Temperatur wirkt nur bei Modellen, die sie unterstützen. GPT-5 und alle neueren OpenAI-Modelle gehören nicht dazu.

Für Onlineshops mit einer breiten Produktpalette ist eine höhere Temperatureinstellung von 0.6-1 oft vorteilhaft, um vielfältige und interessante Beschreibungen zu generieren. Bei Shops mit vielen ähnlichen Produkten sollte eine niedrigere Temperatureinstellung von 0.2-0.4 verwendet werden, um Konsistenz und Klarheit zu gewährleisten. Es kann nützlich sein, verschiedene Temperatureinstellungen zu testen, um herauszufinden, welche am besten zu den spezifischen Anforderungen und dem Stil des Onlineshops passt.

Fehlerbeschreibung
Der Fehler ADMINISTRATION__MISSING_APP_SECRET tritt auf, wenn Shopware das
App-Secret für das BilobaOpenAi Plugin nicht finden kann. Dies kann nach Updates, Migrationen
oder durch beschädigte Installationsdaten passieren.

Lösung 1: Plugin über den Admin neu installieren
Dies ist die einfachste Methode und sollte zuerst versucht werden:

  1. Melde dich im Shopware Admin-Bereich an
  2. Navigiere zu Erweiterungen → Meine Erweiterungen
  3. Suche das Plugin BilobaOpenAi
  4. Klicke auf die drei Punkte rechts neben dem Plugin
  5. Wähle Deinstallieren
  6. Bestätige die Deinstallation
  7. Klicke erneut auf die drei Punkte und wähle Installieren
  8. Nach der Installation klicke auf Aktivieren

Lösung 2: Cache leeren und Apps aktualisieren (SSH/Konsole)
Falls du SSH-Zugang zu deinem Server hast, führe folgende Befehle im
Shopware-Hauptverzeichnis aus:
bin/console app:refresh
bin/console cache:clear
Nach dem Ausführen dieser Befehle lade den Admin-Bereich neu (Strg+F5 oder
Cmd+Shift+R).

Lösung 3: Store-Verbindung prüfen
Manchmal liegt das Problem an der Verbindung zum Shopware Store:

  1. Prüfe ob in Einstellungen → System → Shopware Account die richtige Lizenzdomain steht.
  2. Gehe zu Erweiterungen → Meine Erweiterungen → Shopware Account
  3. Prüfe, ob du eingeloggt sind
  4. Falls nicht, melde dich mit deinem Shopware-Account-Daten an
  5. Falls bereits eingeloggt: Abmelden und erneut anmelden
  6. Gehe dann zu Erweiterungen → Meine Erweiterungen und aktualisiere die
    Liste

Lösung 4: Plugin über Konsole neu laden (SSH)
Falls die obigen Lösungen nicht funktionieren, kannst du das Plugin über die Konsole neu
laden:
bin/console store:download -p BilobaOpenAi
bin/console app:refresh
bin/console app:install --activate BilobaOpenAi
bin/console cache:clear

Wichtige Hinweise
1. Achtung: Erstelle vor allen Änderungen ein Backup deiner Datenbank und Dateien. Bei Problemen kannst du so den vorherigen Zustand wiederherstellen.
2. Info: Nach der Neuinstallation musst du möglicherweise die App-Konfiguration (z.B. API-Schlüssel) erneut eingeben. Notiere dir diese Daten vorher.

Ab Version 7.9.0 (Shopware 6.6 und 6.7) bzw. 3.11.2 (Shopware 6.5) kannst du die App ganz normal deaktivieren, deinstallieren und löschen. Bei älteren Versionen hat Shopware das noch gesperrt.

Lässt sich die App bei dir nicht deaktivieren, aktualisiere sie bitte zuerst auf die aktuelle Version. Danach klappt es wie gewohnt.

Hinweis: Beim Deinstallieren löscht unser Backend die Chats und die Einwilligungs-Protokolle deines Shops.

Wenn sich die Domain deines Shops ändert, erkennt Shopware das und zeigt im Admin den Dialog „Änderung der Shop-ID wird vorgeschlagen“. Solange du dort keine Option wählst, kommuniziert Shopware mit keiner App.

Umzug: Ziehst du denselben Shop dauerhaft auf eine neue Domain oder einen neuen Server um, wähle „Shop-ID beibehalten“. Shopware meldet die Erweiterung dann mit der bisherigen Shop-ID und der neuen Domain bei unserem Backend an, deine Einstellungen bleiben erhalten.

Kopie: Ist die neue Umgebung eine Kopie deines Shops, zum Beispiel eine Staging- oder Testumgebung, wähle „Neue Shop-ID generieren“ (siehe „Funktioniert die Erweiterung auch in Staging- und Testumgebungen?“).

Nur über diesen Dialog erhält unser Backend die neue Anmeldung. Hängst du stattdessen nur die .env-Datei oder den Host um, bleibt bei uns die alte Domain registriert. Die Folge ist eine tote API-Anbindung, zum Beispiel ein leeres Modell-Dropdown, oder das Anlegen eines Chatbots funktioniert nicht.

So gehst du vor

  1. Öffne den Admin deines Shops.
  2. Erscheint der Dialog „Änderung der Shop-ID wird vorgeschlagen“, wähle bei einem Umzug „Shop-ID beibehalten“, bei einer Kopie „Neue Shop-ID generieren“.
  3. Bestätige deine Auswahl.

Dieser Fehler tritt auf, wenn dein Shop hinter Cloudflare oder einer anderen Firewall/WAF liegt und diese die Anfrage unseres Backends an deine Shopware-Admin-API blockiert. Echte Besucher sind davon nicht betroffen, nur die Server-zu-Server-Verbindung wird geblockt.

Prüfe zuerst im Modul „Daten & Logs“ den Tab „Verbindung prüfen“: Er testet die Verbindung live und zeigt dir bei einer Blockade direkt die passende Anleitung an.

Liegt eine Cloudflare-Blockade vor, hilft in der Regel:

  1. Gib unsere ausgehende IP 49.13.22.20 in Cloudflare frei.
  2. Bei Cloudflare Free (häufigster Fall): Deaktiviere den Bot Fight Mode für die betroffene Zone (Security > Bots). Alternativ kannst du unter IP Access Rule eine Allow-Regel für 49.13.22.20 anlegen.
  3. Bei Cloudflare Pro/Business (Super Bot Fight Mode): Nimm 49.13.22.20 bzw. den Pfad /api/ über eine Skip-Regel vom Bot-Schutz aus.
  4. Bot Fight Mode ist pro Cloudflare-Zone gesetzt: Prüfe bei Haupt- und Subshops die jeweils betroffene Zone.

Bei Fragen helfen wir gerne weiter (Kontaktformular).

Der Chatbot antwortet nur auf Seiten, deren Adresse als Domain eines Verkaufskanals deines Shops hinterlegt ist. Ruft ein Besucher den Shop über eine andere Adresse auf, zum Beispiel ohne „www“, über eine alte Domain oder eine Stage, lehnt unser Backend die Anfrage ab.

Prüfe unter Einstellungen → Verkaufskanäle, ob genau die Adresse, über die der Shop aufgerufen wird, als Domain hinterlegt ist.

Zum Schutz deines API-Guthabens begrenzt unser Backend die Nachrichten je Besucher, standardmäßig auf 10 Nachrichten pro Minute und 60 pro Stunde. Zusätzlich gibt es ein Limit pro Shop und Stunde, das von deiner Stufe abhängt. Wird ein Limit erreicht, kann der Besucher nach einigen Minuten weiterschreiben.

Eine einzelne Nachricht darf höchstens 2000 Zeichen lang sein.

OpenAI-Konto: Allgemeine Fragen

Die folgenden Fragen betreffen dein OpenAI-Konto. Wie du API-Schlüssel für Claude, Gemini und Mistral erstellst, steht oben in der Installationsanleitung.

Der OpenAI Account kann über diesen Link erreicht werden: https://platform.openai.com/ .

Hier finden sich die Verwaltung der Credit, Limitierung und die API Schlüssel, welche für die Erweiterung nötig sind!

  1. Zuerst muss ein neues Projekt erstellt werden.
  2. Hier kann ein neuer API Schlüssel erstellt und einem Projekt zugewiesen werden.

Dieser Schlüssel kann in der Konfiguration der Erweiterung eingetragen werden.

Credits sind erforderlich, damit die OpenAI API richtig funktioniert. Wie bei anderen Diensten ist das eine „Prepaid“-Methode. Du lädst die Credits auf und diese werden automatisch “ausgegeben”, sobald die Erweiterung genutzt und eine Anfrage gesendet wird.

Um Credits bei OpenAI aufzuladen, muss über das eigene Profil eine Zahlungsmethode eingerichtet werden.

Die Zahlungsmethoden befinden sich unter: Organization -> Billing. Hier kann über “add payment details” eine neue Zahlungsmethode hinzugefügt werden. Wird dies gemacht, werden auch Credits aufgeladen.

Credits werden in Dollar abgerechnet. OpenAI verbraucht “Tokens” ein Token entspricht ca. 4 Zeichen.

Übersichtstabelle von OpenAI https://openai.com/api/pricing/:

Wenn z.B. nur ein bestimmtes Budget an Credits pro Monat zur Verfügung steht oder zum Schutz können Limits gesetzt werden.

Über das Profil: Organisation -> Limits können monatliche Limits eingestellt werden, sowie eine E-Mail-Benachrichtigung, sobald ein bestimmter Betrag erreicht ist.

OpenAI stellt die Nutzung in verschiedenen “Tiers” zur Verfügung. Zu Beginn befindet sich jeder Nutzer im “Free”-Tier, welches die Nutzung der KI-Modelle sehr stark auf wenige Anfragen pro Minute beschränkt. Sobald $5 bezahlt wurden, werden diese Einschränkungen stark reduziert und die Erweiterung kann effizienter genutzt werden.

Weitere Informationen zu den Limitierungen direkt bei OpenAI: https://platform.openai.com/docs/guides/rate-limits/usage-tiers?context=tier-free

Welches Aktuelle “Tier” erreicht ist, ist im Account hier einzusehen: https://platform.openai.com/settings/organization/limits

Wenn Interesse besteht, dass jemand anderes Einstellungen und Limits prüfen kann, können “members” zur Organisation eingeladen werden.

Zu finden ist der Bereich hier: https://platform.openai.com/settings/organization/members

Hier kann über “invite” eine neue Person hinzugefügt werden. Es stehen zwei Rollenoptionen zur Auswahl, hier kann festgelegt werden, ob das neue Mitglied nur bestimmte Daten einsehen oder an der Organisation mitarbeiten kann. Da die erste Option recht eingeschränkt ist und bestimmte Aufgaben nicht abgegeben werden können, empfiehlt es sich, die Option “Owner” zu vergeben.

Ja. Jede Installation meldet sich mit ihrer eigenen Shop-ID bei unserem Backend an. Eine Stage läuft damit unabhängig vom Live-Shop.

Wichtig ist, dass die Stage eine eigene Shop-ID bekommt. Hast du die Live-Datenbank in die Stage kopiert, zeigt Shopware im Admin den Dialog „Änderung der Shop-ID wird vorgeschlagen“. Wähle dort „Neue Shop-ID generieren“ und nicht „Shop-ID beibehalten“. Sonst meldet sich die Stage mit der Shop-ID des Live-Shops an und überschreibt dessen App-Daten.

Außerdem muss die Stage für unser Backend öffentlich erreichbar sein, eine lokale oder interne Adresse funktioniert nicht. Die Domain der Stage muss als Domain eines Verkaufskanals hinterlegt sein, sonst lädt der Chatbot dort nicht.

Nutzt die Stage dieselbe Wissensbasis wie der Live-Shop, schalte auf der Stage die nächtliche Generierung ab (siehe „Automatische nächtliche Generierung deaktivieren (Test-/Klon-Shops)“).

Wir empfehlen das aktuelle Standardmodell (derzeit GPT-6.1 Sol) oder ein anderes aktuelles Modell.

Aus Kostengründen kannst du auch ein kleineres Modell oder das Vorgängermodell nutzen.

Was ist Reasoning?:

Reasoning ist eine Funktion die das KI-Modell anweist, einen „Denkprozesse“ zu durchlaufen , um Halluzinationen zu vermeiden und die Nachvollziehbarkeit zu erhöhen, bevor eine Antwort gegeben wird.

Reasoning ab dem ChatGPT5.1 Modell:

Seit dem ChatGPT5.1 Modell bietet OpenAI ein Reasoning, welches Antwortzeiten und Qualität der Antworten deutlich verbessert hat.

Nein, die Erweiterung funktioniert ohne PromptPlus. PromptPlus schaltet zusätzlich die Automatik, Zusatzfelder per KI, Custom Fields als Prompt-Variablen und die MCP-Server-Integration frei.

Die Erweiterung unterstützt MCP-Server, die dem Model Context Protocol entsprechen und öffentlich per HTTP(S) erreichbar sind. Die Tools nutzt die KI nur mit GPT-5 und neueren Modellen. Gängige Beispiele sind SEO-Tools, Keyword-Recherche-Dienste und Analyse-Plattformen.

Die Generierung kann etwas länger dauern, da zusätzliche Daten von externen Servern abgerufen werden. Die verbesserte Textqualität durch die Echtzeitdaten kompensiert dies in der Regel.

Ja, für die Abfrage werden relevante Informationen (z.B. Produktname, Keywords) an die konfigurierten MCP-Server gesendet. Achte darauf, nur vertrauenswürdige Server zu verwenden.

Hinweis: Biloba IT übernimmt keine Verantwortung für Daten, die an fremde Server übertragen werden.

Ja, du kannst jeden MCP-kompatiblen Server einbinden. Trage einfach die entsprechenden Zugangsdaten in der Server-Verwaltung ein.

Die Textgenerierung funktioniert auch ohne MCP-Server. Wenn ein Server nicht erreichbar ist, wird der Text ohne die zusätzlichen Daten generiert.

Support

Bei Fragen oder Problemen stehen wir zur Verfügung: