AI Babel Enchanter Dokumentation

Installation

Voraussetzungen

Magento 2.4.x — getestet mit 2.4.9, kompatibel mit früheren 2.4.*-Versionen. PHP 8.1–8.5. Funktioniert sowohl mit dem Standard-Theme Luma als auch mit dem Hyvä-Theme — das Modul läuft vollständig im Admin und schreibt Standard-Katalogattribute, sodass Ihr Storefront die verbesserten Inhalte ohne Template-Änderungen darstellt. Hängt vom kostenlosen Modul codingrow/module-core ab, das automatisch installiert wird. Erfordert einen API-Schlüssel von mindestens einem KI-Anbieter für den Schritt Verbessern/Umschreiben (Anthropic, OpenAI, Google oder OpenRouter) und für die Übersetzung entweder einen Schlüssel für maschinelle Übersetzung (DeepL) oder ein als Übersetzer genutztes LLM. Die gesamte KI- und Übersetzungsnutzung wird Ihnen direkt vom Anbieter berechnet — Codingrow schlägt nie etwas auf.

Einrichtungsschritte

1. Fügen Sie die per E-Mail erhaltenen Zugangsdaten in die Datei auth.json im Stammverzeichnis Ihres Magento-Projekts ein: { "http-basic": { "repo.codingrow.com": { "username": "...", "password": "..." } } }
2. composer config repositories.codingrow composer https://repo.codingrow.com
3. composer require codingrow/module-ai-babel-enchanter
4. bin/magento module:enable Codingrow_BabelEnchanter
5. bin/magento setup:upgrade && bin/magento setup:di:compile && bin/magento cache:flush (setup:di:compile ist bei einem Produktions-Deployment erforderlich; auf einem Entwickler-Setup können Sie es überspringen)
6. Fügen Sie Ihren Lizenzschlüssel unter Admin → Stores → Configuration → Codingrow → AI Babel Enchanter → License → License Key ein, speichern Sie und leeren Sie dann den Cache.

Konfiguration

Stores → Configuration → Codingrow → AI Babel Enchanter.

Deinstallation

Setzen Sie Enable auf No und speichern Sie, um jede Verarbeitung sofort zu stoppen — Ihre Kataloginhalte bleiben genau so, wie sie sind. Wenn Sie zuvor zum Originaltext zurückkehren möchten, führen Sie ein Rollback aus (siehe Benutzerhandbuch). Um das Modul vollständig zu entfernen: bin/magento module:disable Codingrow_BabelEnchanter dann composer remove codingrow/module-ai-babel-enchanter.

Anbieter & Kosten

Anbieter wählen

AI Babel Enchanter hat zwei unabhängige Anbieter-Slots: einen für den Schritt Verbessern/Umschreiben (ein LLM) und einen für die Übersetzung (ein LLM oder ein dedizierter maschineller Übersetzungsdienst wie DeepL). Sie bringen Ihre eigenen Schlüssel mit und die gesamte Nutzung wird Ihnen direkt vom gewählten Anbieter berechnet — Codingrow schlägt nie etwas auf. Wählen Sie das Verbesserungsmodell nach Qualität und übersetzen Sie mit demselben LLM oder mit einem günstigeren MT-Schlüssel pro Zeichen.

Anthropic (Claude-Modelle)

1. Melden Sie sich bei console.anthropic.com an.
2. Gehen Sie zu console.anthropic.com/settings/keys.
3. Klicken Sie auf Create Key, benennen Sie ihn (z. B. "AI Babel Enchanter") und kopieren Sie den Wert.
4. Fügen Sie ihn in den Anbieter-Slot mit Provider auf Anthropic ein und nutzen Sie dann Load models.

OpenAI (GPT-Modelle)

1. Melden Sie sich bei platform.openai.com an.
2. Gehen Sie zu platform.openai.com/api-keys.
3. Klicken Sie auf Create new secret key, benennen Sie ihn und kopieren Sie ihn sofort — er wird nur einmal angezeigt.
4. Fügen Sie ihn in den Anbieter-Slot mit Provider auf OpenAI ein und nutzen Sie dann Load models.

Google (Gemini-Modelle)

1. Melden Sie sich bei aistudio.google.com mit einem Google-Konto an.
2. Gehen Sie zu aistudio.google.com/app/apikey.
3. Klicken Sie auf Create API key, wählen oder erstellen Sie ein Google-Cloud-Projekt und kopieren Sie den Schlüssel.
4. Fügen Sie ihn in den Anbieter-Slot mit Provider auf Google ein und nutzen Sie dann Load models.

OpenRouter (ein Schlüssel, Modelle vieler Anbieter)

1. Melden Sie sich bei openrouter.ai an.
2. Gehen Sie zu openrouter.ai/keys.
3. Klicken Sie auf Create Key, benennen Sie ihn und kopieren Sie den Wert.
4. Fügen Sie ihn in den Anbieter-Slot mit Provider auf OpenRouter ein und nutzen Sie dann Load models.

DeepL (maschinelle Übersetzung)

1. Melden Sie sich bei deepl.com/pro-api an.
2. Öffnen Sie Account → API keys und kopieren Sie Ihren Authentication Key.
3. Fügen Sie ihn in den Slot Translation provider ein, mit dem Übersetzer auf DeepL.

DeepL wird pro Zeichen abgerechnet (etwa 20 € pro 1M Zeichen), meist günstiger als ein LLM für reine Übersetzung. Sie können DeepL auch ganz weglassen und mit demselben LLM wie beim Verbesserungsschritt übersetzen.

Load models — keine Modell-id zum Eintippen

Sobald der API-Schlüssel eingetragen ist, speichern Sie den Abschnitt und klicken Sie auf Load models unter dem Feld Model: das Modul ruft mit Ihrem Schlüssel den Modell-Listen-Endpunkt des Anbieters auf und füllt ein Dropdown mit jedem Modell, das Ihr Schlüssel tatsächlich nutzen kann — wählen Sie aus der Liste, statt eine id einzutippen. Ein manuelles Textfeld bleibt als Fallback für eine noch nicht gelistete Modell-id. Ein Link direkt unter dem Feld verweist stets auf die richtige Schlüsselseite des aktuell gewählten Anbieters.

Die Kosten eines Laufs über den gesamten Katalog schätzen

Ein vollständiger Durchlauf hat zwei Kostentreiber, die sich pro Produkt summieren: Verbessern (LLM-Tokens, Preis pro Million) und Übersetzen (Zeichen, Preis pro Million, mal Anzahl der Zielsprachen). Nutzen Sie den Rechner unten, um einen Lauf vor dem Start zu dimensionieren — es ist eine rein indikative Schätzung; Ihre tatsächlichen Zahlen hängen von der Inhaltslänge und den gewählten Modellen ab.

Benutzerhandbuch

Profile und Persona-Prompt

Alles, was das Modul tut, ist in Profilen organisiert. Ein Profil ist eine wiederverwendbare Konfiguration, die Sie auf einen Ausschnitt des Katalogs anwenden: welche Attribute es anfassen darf, die anzuwendende Schritt-Pipeline, eine optionale exklusive Kategorie, damit das Profil nur auf Produkte dieser Kategorie wirkt, und einen Persona-Prompt — Freitext-Anweisungen, die Tonfall und Regeln der Umschreibung festlegen. Profile sind Anti-Revert: Ein bereits von einem Profil verarbeitetes Produkt wird beim nächsten Lauf übersprungen, sofern Sie es nicht zurücksetzen, sodass erneutes Ausführen sicher ist.

Gruppen und Schritte (die Pipeline)

Innerhalb eines Profils definieren Sie Gruppen von Schritten, die der Reihe nach laufen. Die beiden Kernschritt-Typen sind improve (den Quelltext mit dem Verbesserungs-Anbieter umschreiben/anreichern) und translate (die zielsprachlichen Versionen erzeugen). Die normale Pipeline ist improve → translate: Zuerst wird die Ausgangssprache umgeschrieben, dann wird der verbesserte Text übersetzt, sodass jede Store View die bessere Fassung erbt, statt den alten Text zu übersetzen. Durch Gruppieren können Sie verschiedene Schritte auf verschiedene Attribute anwenden und als einen Vorgang ausführen.

Cross-sell, verwandte und Up-Sell (KI-Relationen)

Drei unabhängige Schalter erlauben es einem Profil, mithilfe der KI Cross-Sell-, verwandte und Up-Sell-Produkte vorzuschlagen. Das Modell schlägt immer nur echte SKUs aus Ihrem Katalog vor — es kann kein nicht existierendes Produkt erfinden — und die Vorschläge werden in Magentos native Cross-Sell-/verwandte/Up-Sell-Verknüpfungen geschrieben, sodass sie in den Standard-Storefront-Blöcken erscheinen. Aktivieren Sie nur die Relationstypen, die das Modul verwalten soll.

Dry-Run-Vorschau (und gerendert)

Bevor irgendetwas geschrieben wird, führen Sie ein Profil im Dry-Run aus: das Modul erzeugt die vorgeschlagenen Inhalte für eine Stichprobe von Produkten und zeigt sie neben dem aktuellen Text an, inklusive einer gerenderten Vorschau, sodass Sie sehen, wie die verbesserte Beschreibung tatsächlich auf der Seite aussieht — nicht nur der Rohtext. Im Dry-Run wird nichts gespeichert; er dient dazu, den Persona-Prompt und die Pipeline zu validieren, bevor Sie sich auf einen vollständigen Lauf festlegen.

Das "Enrichments & Translations"-Raster

Der Tab "Enrichments & Translations" ist das Arbeitsraster: jedes generierte Feld für jedes Produkt und jede Sprache, paginiert und filterbar. Sie können jeden generierten Wert vor oder nach der Anwendung inline bearbeiten — die KI-Ausgabe ist ein Ausgangspunkt, keine Sperre — und jede Zeile behält einen Link zum Originaltext, sodass Sie den Originalwert wiederherstellen können, wenn Ihnen das Ergebnis nicht gefällt. Das ist die Human-in-the-Loop-Ebene über der automatisierten Pipeline.

Rollback

Jeder vom Modul geschriebene Wert ist reversibel. Zusätzlich zum zeilenweisen Original wiederherstellen im Raster setzt der CLI-Befehl babel:rollback Inhalte in großem Umfang zurück — pro Profil, pro Produkt oder für den gesamten Lauf — auf den Text, der vor dem Eingriff des Moduls vorhanden war. Da das Original stets erhalten bleibt, ist ein Lauf über den gesamten Katalog nie eine Einbahnstraße.

Queue und Guthaben-Circuit-Breaker

Lange Läufe werden über eine Warteschlange verarbeitet, die Sie beobachten, pausieren und fortsetzen können. Der integrierte Circuit Breaker (konfiguriert unter Resilience) schützt den Lauf: bei wiederholten Anbieterfehlern — meist Anbieter ohne Guthaben oder mit Rate Limit — pausiert er nach N Fehlern, wartet den konfigurierten Cooldown ab und kann vorübergehende Fehler automatisch wiederholen, statt den ganzen Batch scheitern zu lassen. Wenn Sie Guthaben aufladen oder das Limit zurückgesetzt wird, setzen Sie die Warteschlange fort und sie macht dort weiter, wo sie aufgehört hat.

Befehlszeile (CLI)

Alles lässt sich für Planung und große Läufe über die CLI steuern.