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

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Halbjährlich49,99 €16 % günstiger
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.