Die Übersetzung ist korrekt, die Glossarbegriffe stimmen, und trotzdem klingt sie noch wie eine Übersetzung. Rephrase ist die Pipeline-Phase, die genau diese letzte Lücke schließt: Ein KI-Agent schreibt die aktuelle Ausgabe so um, dass sie sich in der Zielsprache wie ein muttersprachlich verfasster Text liest – bei unveränderter Bedeutung sowie identischen Platzhaltern und Tags.
Diese Seite behandelt die Phase rephrase für sich allein: was sie umschreibt, was sie unverändert lässt, was passiert, wenn der Durchlauf fehlschlägt, und die eine Entscheidung, vor die sie Sie stellt: aktivieren oder überspringen. Neu in der Pipeline? Starten Sie mit dem Überblick zur asynchronen Lokalisierungs-Pipeline, um zu sehen, wie die Phasen zusammenspielen. Rephrase gibt es nur asynchron – sie läuft für Jobs, die über die asynchrone Lokalisierungs-API erstellt werden, nie für den synchronen Aufruf /localize.
Was sie macht#
Eine wörtliche Übersetzung kann die Formulierungen der Ausgangssprache in die Zielsprache mitnehmen – grammatikalisch korrekt, aber klar als Übersetzung erkennbar. Die Rephrase-Phase schreibt die aktuell beste Ausgabe so um, dass sie wie muttersprachlicher Text klingt: natürlich und idiomatisch in der Zielsprache, mit einer idiomatischen Entsprechung statt einer Wort-für-Wort-Wiedergabe. Die ursprüngliche Bedeutung und Absicht bleiben erhalten, und sie nutzt das Glossar, die Markenstimme und die Anweisungen Ihres Engine – dieselbe Konfiguration, die die Übersetzung erzeugt hat, steuert auch die Umschreibung.
Sie läuft nach den Verfeinerungsschritten durch KI und Menschen – auf der Ausgabe, die bis dahin vorliegt. Deshalb funktioniert sie gleich, unabhängig davon, ob menschliche Prüfung und KI-Nachbearbeitung aktiviert sind oder nicht: In beiden Fällen schreibt sie die aktuell beste Version um. Wenn außerdem die Rückübersetzungsprüfung aktiviert ist, prüft sie die umgeschriebene Ausgabe, nicht die Version davor.
Ein wörtlicher Durchlauf bleibt nah an der Formulierung der Quelle; Rephrase rückt den Text näher daran, wie ihn ein Muttersprachler formulieren würde. Deshalb sind beide nicht austauschbar – welche Variante Sie wollen, entscheiden Sie unten.
Ihre Platzhalter und Tags bleiben erhalten#
Die naheliegende Frage bei einer Phase, deren Aufgabe das Umschreiben von Text ist: Fasst sie die Teile an, die keine Prosa sind? Nein. Rephrase lässt Platzhalter, Variablen, Tags und Formatierung exakt unverändert – umgeschrieben werden nur die Wörter drumherum, nicht die Token, von denen Ihre App abhängt.
Ein String wie dieser behält also jede Interpolation und jedes Tag bei – nur der lesbare Text ändert sich:
Source (en): "Hi {firstName}, you have <b>{count}</b> new messages."
Translated (de): "Hallo {firstName}, du hast <b>{count}</b> neue Nachrichten."
After rephrase (de):"Hey {firstName}, <b>{count}</b> neue Nachrichten warten auf dich."{firstName}, {count} und die Tags <b> sind in allen drei Versionen identisch. Der Text liest sich auf Deutsch natürlicher; die Struktur, auf die sich die Laufzeitumgebung verlässt, bleibt unverändert.
Wenn Rephrase fehlschlägt, scheitert der Job nicht#
Rephrase ist eine nicht kritische Phase. Eine KI-Umschreibung kann fehlschlagen oder in ein Timeout laufen – und wenn das passiert, geht die Übersetzung, für die Sie bereits bezahlt haben, nicht verloren. Die vorherige Ausgabe wird unverändert übernommen und der Job läuft weiter. Sie setzen also keine korrekte Übersetzung für einen stilistischen Feinschliff aufs Spiel.
Eine fehlgeschlagene Rephrase lässt den Job nicht scheitern. Sie erscheint als Schritteintrag mit status: failed, der Job endet als completed_with_warnings, und die Übersetzung vor der Umschreibung landet in outputData:
{
"id": "ljb_C3d4E5f6G7h8I9j0",
"status": "completed_with_warnings",
"outputData": {
"greeting": "Hallo {firstName}, du hast <b>{count}</b> neue Nachrichten."
},
"warnings": [
{ "step": "rephrase", "message": "<the failure reason for this step>" }
],
"steps": [
{ "stepId": "localize", "type": "action", "status": "completed" },
{ "stepId": "rephrase", "type": "action", "status": "failed" }
]
}Ausgeliefert wurde die Übersetzung aus de. Der genaue Text von message dient hier nur zur Veranschaulichung – entscheidend ist die Struktur: ein warnings[]-Eintrag mit step und message, der Schritt rephrase als failed protokolliert und die Ausgabe vor der Umschreibung in outputData erhalten. Im Feld step sehen Sie, dass der Text in diesem Durchlauf nicht stilistisch verfeinert wurde – so können Sie diese Sprache erneut ausführen, wenn natürliche Formulierungen dafür wichtig sind. Unter Pipeline-Ausführungen beobachten finden Sie die vollständige Struktur von steps[] und warnings sowie Informationen dazu, wie nicht kritische Fehler zu completed_with_warnings zusammengefasst werden.
Nicht kritisch heißt bewusst Best-Effort
Das Aktivieren von Rephrase kann die Zuverlässigkeit eines Jobs nicht verringern. Im schlechtesten Fall erhalten Sie die Übersetzung, die Sie auch ohne diese Phase ausgeliefert hätten – plus eine Warnung. Genau deshalb können Sie sie breit aktivieren und den stilistisch verfeinerten Text als Upgrade statt als Abhängigkeit behandeln.
Wann aktivieren, wann überspringen#
Rephrase optimiert genau eine Sache: dass sich ein Text wie ein muttersprachliches Original liest. Für manche Inhalte ist das genau richtig, für andere genau falsch – deshalb ist das eine Entscheidung pro Inhalt, kein globaler Standard.
Aktivieren Sie sie für Marketingtexte, Landingpages, Produktbeschreibungen und Onboarding – überall dort, wo es wichtiger ist, wie muttersprachlicher Text zu klingen, als nah an der Formulierung der Quelle zu bleiben.
Überspringen Sie sie bei technischen und rechtlichen Inhalten, bei denen wörtliche Genauigkeit Vorrang hat. Rephrase formuliert um, damit Texte natürlich klingen; bei einer Vertragsklausel, einer API-Referenz oder einem Compliance-String ist eine Formulierung näher an der Quelle die sicherere Wahl. Lassen Sie Rephrase für solche Inhalte ausgeschaltet und übernehmen Sie die Ausgabe des Schritts Kernlokalisierung unverändert.
Natürliche Formulierung ist ein Trade-off, kein Gratisgewinn
Rephrase entfernt sich ganz bewusst von der Formulierung der Quelle. Genau das ist bei Marketingtexten der Zweck – und bei allem ein Risiko, wo die exakte Formulierung rechtliches oder technisches Gewicht hat. Wenn Sie unsicher sind, auf welcher Seite eine bestimmte Nutzlast steht, überspringen Sie Rephrase dafür – wörtlich ist der sicherere Standard.
So schalten Sie Rephrase ein#
Rephrase wird wie jede andere Phase konfiguriert – mit einem Standard auf Engine-Ebene plus einer optionalen Überschreibung pro Anfrage. Die vollständige Konfiguration finden Sie daher unter Die Pipeline konfigurieren. Kurz gesagt: Schalten Sie sie im Tab Pipeline Ihres Engine ein, um sie auf jeden Job anzuwenden, oder setzen Sie sie für eine einzelne Übermittlung mit pipelineConfig:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr"],
"data": { "headline": "Ship global products faster." },
"pipelineConfig": {
"rephrase": { "enabled": true }
}
}Phasen, die Sie weglassen, übernehmen die Engine-Konfiguration – die obige Überschreibung aktiviert Rephrase also für diese Übermittlung, ohne eine andere Phase zu verändern. So können Sie Rephrase im Engine für wörtliche Inhalte ausgeschaltet lassen und sie pro Anfrage für Marketing-Nutzlasten einschalten, die davon profitieren.
