Handbuch KI Übersetzungsmanager.

Von der Einrichtung bis zur Übernahme: Anbieter hinterlegen, Job anlegen, sammeln und übersetzen, Glossar pflegen, prüfen und freigeben - und wissen, was eine Fehlermeldung bedeutet.

Systemvoraussetzungen

Shopware 6.7, PHP 8.2 oder neuer und ein eigener API-Key beim gewünschten KI-Anbieter. Für geplante Läufe muss der Nachrichtenverarbeiter von Shopware laufen; manuelle Läufe kommen ohne aus.

Kosten: Die Übersetzung läuft über deinen eigenen Zugang bei OpenAI, Anthropic, Mistral oder Google. Abgerechnet wird direkt mit dem Anbieter, es läuft nichts über unsere Server.

Installation

ZIP im Admin unter Erweiterungen hochladen, installieren, aktivieren. Danach den Lizenzschlüssel eintragen; die Prüfung braucht eine im Verkaufskanal hinterlegte Shop-Domain.

Alle Einstellungen liegen im Admin-Modul unter der Plugin Suite. Es gibt bewusst keine Konfigurationsdatei.

KI-Anbieter einrichten

Wähle Anbieter und Modell und hinterlege den API-Key. Über den Verbindungstest prüfst du beides, bevor der erste Lauf startet.

Zur Wahl stehen OpenAI, Anthropic, Mistral und Google Gemini. Welches Modell sinnvoll ist, hängt von Textmenge und Anspruch ab - für Katalogtexte reichen die schnelleren Modelle meist aus.

Einen Job anlegen

Zuerst wählst du den Verkaufskanal. Er steht bewusst an erster Stelle, denn er bestimmt, welche Sprachen und welcher Bestand überhaupt zur Auswahl stehen.

Danach folgen Umfang und Felder, anschließend Quellsprache und Zielsprachen sowie Anbieter und Modell.

Empfehlung: Starte mit einem kleinen Umfang und einer Zielsprache. So siehst du am Ergebnis, ob Ton und Glossar passen, bevor du den ganzen Katalog bewegst.

Sammeln

Beim Sammeln werden die Quelltexte eingelesen und als einzelne Einträge angelegt. Erst danach steht fest, wie viele Texte tatsächlich zu übersetzen sind.

Texte, die sich seit dem letzten Lauf nicht geändert haben, werden über eine Prüfsumme erkannt und nicht erneut geschickt. Das spart Kosten und hält bereits geprüfte Übersetzungen stabil.

Übersetzen

Beim Starten gehen die Einträge gebündelt an das Modell. Ein Fenster zeigt den Fortschritt mit Prozentwert, verarbeiteten von gesamten Einträgen und der verbleibenden Anzahl.

Manuelle Läufe werden im Admin in kurzen Abschnitten abgearbeitet und brauchen keinen laufenden Nachrichtenverarbeiter. Geplante Läufe nutzen weiterhin die Warteschlange, weil sie ohne geöffneten Admin ablaufen müssen.

Anhalten und fortsetzen

Ein laufender Job lässt sich über den Abbrechen-Knopf im Fortschrittsfenster anhalten. Der bereits erreichte Fortschritt bleibt erhalten.

Über "Fortsetzen" lässt sich der Lauf später weiterführen. Das gilt auch für Läufe mit dem Status Läuft, Bereit oder Übersetzt, die in einer früheren Version steckengeblieben sind.

Glossar

Im Glossar hinterlegst du Begriffe, die in jeder Sprache gleich bleiben oder auf eine bestimmte Weise übersetzt werden sollen - Markennamen, Produktbezeichnungen, Fachbegriffe.

Die Einträge werden dem Modell bei jeder Anfrage mitgegeben. Damit bleibt die Sprache über alle Läufe hinweg einheitlich, auch wenn das Modell zwischendurch wechselt.

Prüfen, freigeben, übernehmen

Übersetzte Texte liegen zunächst als Entwurf vor. Du siehst Quelle und Übersetzung nebeneinander und kannst einzelne Texte anpassen, bevor du sie freigibst.

Erst die Übernahme schreibt die freigegebenen Texte in die Übersetzungstabellen von Shopware. Bis dahin ist im Shop nichts verändert.

Reihenfolge beachten: Nur freigegebene Einträge werden übernommen. Alles, was noch im Entwurf steht, bleibt außen vor.

Zeitplan

Wiederkehrende Läufe lassen sich planen, etwa wöchentlich für neu hinzugekommene Artikel. Diese Läufe gehen über die Nachrichtenwarteschlange und brauchen einen eingerichteten Verarbeiter.

Fehlermeldungen verstehen

Seit Version 1.8.0 sind die Meldungen in verständlicher Sprache formuliert, auf Deutsch und Englisch. Statt einer technischen Rohantwort steht dort, was schiefging und wo zu prüfen ist.

Erkannt und benannt werden unter anderem: fehlender oder abgelehnter API-Key, erreichtes Anfragelimit, Störung beim Anbieter, nicht erreichbarer Anbieter, unlesbare Modellantwort und eine abweichende Anzahl gelieferter Texte.

Unbekannte Meldungen werden auf eine Zeile gebracht und nach 120 Zeichen gekürzt, damit die Ansicht nicht waagerecht ausbricht.

Problemlösung

Lauf bleibt auf "Läuft" stehen: Bei geplanten Läufen fehlt vermutlich der Nachrichtenverarbeiter. Über "Fortsetzen" lässt sich der Lauf auch ohne ihn abschließen.
API-Key wird abgelehnt: Der Verbindungstest sagt, ob Schlüssel und Modell im Anbieterkonto freigeschaltet sind.
Begriffe werden falsch übersetzt: Trage sie ins Glossar ein und starte den Lauf erneut. Bereits freigegebene Texte bleiben davon unberührt.

Support

Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.

Alle Einstellungen

Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.9.3).

Übersetzen

Umfang und Sprachen wählen. Die Übersetzung läuft im Hintergrund und wird direkt übernommen.

VerkaufskanalStandard: Alle Verkaufskanäle

Begrenzt die Übersetzung auf einen Verkaufskanal. Bei Produkten werden dann nur die dort sichtbaren Produkte berücksichtigt und die Zielsprachen auf die Sprachen des Kanals beschränkt. Ohne Auswahl stehen alle Sprachen zur Verfügung und der gesamte Bestand wird berücksichtigt.

UmfangStandard: Produkte

Was übersetzt wird: Produkte, Kategorien, Hersteller, Eigenschaften oder Eigenschaftswerte. Bei Herstellern wird nur die Beschreibung übersetzt, der Name bleibt als Eigenname unverändert.

QuellspracheStandard: -

Die Sprache, aus der übersetzt wird. Ihre Texte dienen als Vorlage für alle Zielsprachen.

ZielsprachenStandard: keine

Eine oder mehrere Sprachen, in die übersetzt wird. Die Übersetzungen werden direkt unter der jeweiligen Sprache gespeichert.

FelderStandard: -

Welche Textfelder des gewählten Umfangs übersetzt werden, etwa Name, Beschreibung oder Meta-Angaben. Die Auswahl richtet sich nach dem Umfang.

Varianten einbeziehenStandard: aus

Zusätzlich zu den Hauptprodukten auch Varianten mit eigenen Texten übersetzen. Erhöht die Menge deutlich.

Alles neu übersetzenStandard: aus

Standardmäßig werden nur Texte verarbeitet, die sich seit der letzten Übersetzung geändert haben. Einschalten, wenn nach einem Modell- oder Tonalitätswechsel wirklich alles neu übersetzt werden soll. Das kostet den vollen Betrag.

Zusätzliche AnweisungStandard: leer

Gilt nur für diesen Lauf und hat Vorrang vor den allgemeinen Regeln. Wirkt auch in der Vorschau, damit sich die Wirkung vorher prüfen lässt.

Allgemein

KI-AnbieterStandard: OpenAI

Der Dienst, der die Texte übersetzt: OpenAI, Anthropic, Mistral oder Google. Die Texte werden an diesen Anbieter übermittelt. Mit Verbindung testen lässt sich der Zugang prüfen.

API-KeyStandard: leer

Zugangsschlüssel für den gewählten Anbieter. Jeder Anbieter hat sein eigenes Feld, der Schlüssel wird beim Wechsel nicht verworfen.

ModellStandard: je nach Anbieter, bei OpenAI GPT-5.6 Luna

Das Modell des gewählten Anbieters. Ohne Auswahl nutzt das Plugin das Standardmodell des Anbieters.

Verhalten

Tonalität der Übersetzung. Die Bündelung der Anfragen richtet sich automatisch nach der Art des Feldes.

TonalitätStandard: leer

Wird dem System-Prompt hinzugefügt. Beschreibt Stil und Anrede, etwa sachlich oder ob Kunden geduzt werden.

Zeitplan

Automatisch in festem Abstand übersetzen. Es werden nur geänderte Texte verarbeitet.

Automatisch übersetzenStandard: aus

Benötigt einen laufenden Shopware Scheduled Task. Manuelle Läufe bleiben jederzeit möglich.

Abstand (Stunden)Standard: 24

Wie viele Stunden zwischen zwei automatischen Läufen liegen. Möglich sind 1 bis 720.

QuellspracheStandard: -

Die Ausgangssprache für die automatischen Läufe.

Umfänge im ZeitplanStandard: keine

Welche Umfänge die automatischen Läufe abdecken, also Produkte, Kategorien, Hersteller, Eigenschaften oder Eigenschaftswerte.

Zielsprachen im ZeitplanStandard: keine

Es werden alle Felder des jeweiligen Umfangs verarbeitet.

Glossar

Verbindliche Begriffe. Markennamen können von der Übersetzung ausgenommen werden.

BegriffStandard: -

Der Begriff in der Ausgangssprache, für den eine feste Übersetzung gelten soll.

ÜbersetzungStandard: -

Die verbindliche Übersetzung des Begriffs. Bleibt gesperrt, wenn der Begriff nicht übersetzt werden soll.

SpracheStandard: Alle Sprachen

Für welche Zielsprache der Eintrag gilt, oder für alle Sprachen.

Nicht übersetzenStandard: aus

Für Markennamen und Produktlinien, die in jeder Sprache gleich bleiben sollen.

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Bester PreisJährlich89,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.