Produkt/Kategorie Beschreibung mit KI (ChatGPT | Gemini | Claude): Installation und Einrichtung

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

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üssen ein, dieser sollte bei OpenAI mit “sk-proj” anfangen.
• Wähle dein gewünschten KI-Modell aus.

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.

KI-Texte in Freitextfelder (Custom Fields): Produkt- und Kategorieseite (Prompts Plus)

Premium-Funktion: Diese Funktion erfordert den In-App-Kauf “Prompts Plus”. Ohne aktiven IAP ist die Box ausgeblendet.

Auf der Produkt- und Kategorieseite steht im Tab „Freitextfelder” eine Box zur Verfügung, mit der KI-Texte direkt in textfähige Custom Fields geschrieben werden können. Über die Massenbearbeitung lassen sich Custom Fields auch für mehrere Produkte oder Kategorien gleichzeitig befüllen (Typ „Produkt-Zusatzfeld” bzw. „Kategorie-Zusatzfeld” im Massenupdate, Prompts Plus IAP):

• 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.
• 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.

Textbearbeitung Bulk

• Gehe zu Kataloge -> Text AI – Massenupdate.
• in “Bereich” kann der gewünschte Bereich ausgewählt werden, der bearbeitet werden soll.
  • Produktbeschreibung
  • Produkt-Zusatzfeld (Prompts Plus IAP)
  • Kategorie-Zusatzfeld (Prompts Plus IAP)
• 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

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

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 → Plugins → Text AI Prompts.
2. Über das Massenupdate: Im Massenupdate-Modul findest du einen Link “Prompts konfigurieren” direkt in der Konfigurationsansicht.

Verfügbare Bereiche

In dieser Erweiterung stehen dir folgende Bereiche zur Verfügung:

• Produktbeschreibung: Generierung von Produkttexten
• Kategoriebeschreibung: Generierung von Kategorietexten
• Zusatzfelder (Custom Fields): KI-Texte für eigene Freitextfelder an Produkten und Kategorien (Prompts Plus)

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 KI-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 → Text 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

1. Sei spezifisch: Je genauer Ihre 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 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.

Text AI Logs und Daten

Das Log-Modul notiert jeden Job, der für die einzelnen Bereiche gelaufen ist. Läuft ein Job nicht durch, ist der Log die erste Anlaufstelle.

Du findest die Logs unter Kataloge im Log-Bereich der Erweiterung (Text AI – Logs und 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.

In-App Käufe

Prompts Plus

Ein Teil der Funktionen gehört zum In-App-Kauf Prompts Plus. Damit schaltest du frei:

• KI-Texte in Zusatzfeldern (Custom Fields) an Produkten und Kategorien
• Custom Fields als Variablen in deinen eigenen Prompts
• Die Text-Automatik für neu angelegte Produkte und Kategorien

Die Erzeugung von Produkt- und Kategoriebeschreibungen (einzeln und über die Massenbearbeitung) funktioniert auch ohne Prompts Plus.

Prompts Plus buchst du direkt im Shopware Store bei der Erweiterung. Nach dem Kauf stehen die zusätzlichen Funktionen ohne weitere Einrichtung zur Verfügung.

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