Übersetzungspipeline konfigurieren
Speichern Sie die Stufen der Engine, bevor Sie einen Job starten, und sehen Sie sich an, welche Stufen tatsächlich ausgeführt werden.
Ein Lokalisierungsjob verwendet die Pipeline-Konfiguration der Engine, die zum Zeitpunkt des Starts festgehalten wird. Konfigurieren Sie die Engine daher, bevor Sie /start aufrufen. Spätere Änderungen an der Engine gelten nur für künftige Starts, nicht für den Snapshot eines bereits laufenden Jobs.
Öffne in Studio den Tab Pipeline der Engine oder aktualisiere pipelineConfig über PATCH /v2/engines/:id. Der Aufrufer benötigt die Berechtigung, die Engine zu bearbeiten. Die Organisation benötigt Zugriff auf die Funktionen, die von den ausführbaren Stufen benötigt werden. Siehe Funktionszugriff und Preise.
Vollständige Konfiguration speichern #
Lesen Sie die Engine mit GET /v2/engines/:id aus, bevor Sie eine bestehende Konfiguration ändern. Wenn Sie pipelineConfig senden, wird diese Konfiguration ersetzt; nicht angegebene Stufen erhalten ihre Standardwerte. Übernehmen Sie also alle Einstellungen, die erhalten bleiben sollen.
Diese Anfrage konfiguriert die Übersetzung mit einem zusätzlichen Umformulierungsdurchlauf. Optionale Stufen, die darin nicht enthalten sind, werden deaktiviert:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}Verwenden Sie eine separate Engine, wenn eine Anwendung für eine bestimmte Art von Jobs eine eigene Richtlinie benötigt. Konfigurieren Sie deren Modelle und Vorgaben und wählen Sie beim Erstellen dieser Jobs einfach ihre ID aus.
Einstellungen der Stufen #
Feld in pipelineConfig | Einstellungen |
|---|---|
localize | enabled: true. Die Übersetzung ist erforderlich. |
preEdit, rephrase, postEdit, backTranslation | enabled (Boolean). Standardwert: false. |
qualityGate | Boolescher Wert enabled und strictness: "strict", "medium" oder "lax" (Standard: "medium"). |
humanEdit | enabled, positive Ganzzahl timeoutHours (Standard: 48) und routes für die Prüfung. |
contentLength | enabled sowie mode (siehe unten). |
Post-Editing setzt eine menschliche Prüfung voraus. Ein Post-Editing-Durchlauf arbeitet mit dem Ergebnis der menschlichen Bearbeitung. Wird diese umgangen oder läuft ein Zeitlimit ab, gibt es unter Umständen kein menschliches Ergebnis, das verfeinert werden kann.
Für die Inhaltslänge stehen die Modi { "_tag": "noLongerThanSource" } (Standard), { "_tag": "fixedCap", "maxColumns": 40 } oder { "_tag": "matchSource", "tolerancePct": 10 } zur Verfügung. Numerische Werte müssen positive Ganzzahlen sein. Es handelt sich um Zielwerte für Anzeigespalten, nicht um Byte-Limits, und sie garantieren nicht, dass der Text in die UI passt.
Menschliche Prüfung weiterleiten #
Erstellen Sie zuerst Entscheidungspools oder wählen Sie vorhandene aus. Jeder humanEdit.routes-Eintrag benennt einen Pool sowie dessen Sprach- und Verzeichnisbereich. Diese Konfiguration leitet alle neu übersetzten Inhalte an einen einzigen Pool weiter:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Ein leeres locales-Array deckt alle Sprachen ab. Fügen Sie "path": ["emails/**"] innerhalb von match hinzu, um Dokumente in diesem Verzeichnis einzubeziehen; abgeglichen wird dabei mit dem key des Dokuments. Pfade bezeichnen literale Verzeichnisse, gefolgt von /**. Eine Route ohne path gilt verzeichnisübergreifend. Spezifischere Übereinstimmungen bei Verzeichnis und Sprache haben Vorrang; widersprüchliche Routen werden abgelehnt.
Für eine gezielte Prüfung aktiviere die Prüfung durch Menschen und füge eine Route hinzu, die die dafür vorgesehenen Übersetzungen abdeckt. Füge qualityGate innerhalb von pipelineConfig ein und behalte die übrigen Einstellungen bei:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Du kannst qualityGate als aktiviert speichern, während humanEdit.enabled auf false steht. Studio behält die gespeicherte Einstellung bei, wenn du die Prüfung durch Menschen aus- und wieder einschaltest. Nimm bei Verwendung der API qualityGate in jeden Ersatz für pipelineConfig auf, damit die Einstellung erhalten bleibt. Das Quality Gate greift nur, wenn die Prüfung durch Menschen in der für den Auftrag ermittelten Pipeline aktiviert ist.
Das Gate speichert für jede Einheit die gefundenen Befunde. "strict" verlangt bei jedem Befund eine Prüfung, "medium" bei schwerwiegenden oder kritischen Befunden und "lax" nur bei kritischen Befunden. Eine Übersetzung, die das Gate nicht auswerten konnte, geht trotzdem in die Prüfung. Setzen Sie qualityGate.enabled für Alles auf false – dann wird jede neue Übersetzung, die von einer Route abgedeckt ist, zur Prüfung weitergeleitet. Wiederverwendete Übersetzungen verursachen keinen neuen Prüfungsaufwand.
Die Beurteilung selbst hängt nicht von der Strenge ab; das Level wird lediglich auf die Befunde angewendet. Eine Änderung des Levels einer Engine gilt für künftige Jobstarts, nicht für die festgehaltene Konfiguration eines bereits laufenden Jobs. Beschreibungen und Definitionen der Schweregrade finden Sie unter Level des Quality Gates.
Die ältere Async Localization API akzeptiert humanEdit.qualityThreshold weiterhin, ignoriert den Wert jedoch. Jede Übersetzung in einer Sprache, die für die menschliche Prüfung ausgewählt ist, geht an Prüferinnen und Prüfer. Für eine selektive Prüfung in der aktuellen Pipeline legen Sie in den Einstellungen Menschliche Prüfung der Engine das Prüfungslevel fest.
Ob die Prüfung verfügbar ist, hängt vom Tarif der Organisation und von der Anbieterverbindung des Pools ab. Beim Start des Jobs werden nicht verfügbare Stufenfunktionen deaktiviert – ebenso wie alle Stufen, die davon abhängen. Lesen Sie die Zielstufen des Jobs aus, um den tatsächlich wirksamen Workflow zu bestätigen. Wenn für die Veröffentlichung eine menschliche Entscheidung erforderlich ist, setzen Sie diese Richtlinie durch, bevor Sie die heruntergeladene Ausgabe ausliefern.
Ergebnis ansehen #
Die Quality-Gate-Stufe speichert für jede ausgewertete Einheit folgende Ausgabe:
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span ist ein wörtliches Zitat aus der Übersetzung, die das Gate beurteilt hat. reason besteht aus einem einzigen englischen Satz. Die Kategorien sind accuracy, terminology, guidance, fluency und style; die Schweregrade sind critical, major und minor. Ein leeres findings-Array bedeutet, dass das Gate keine Fehler gefunden hat. Prüfungseinheiten geben diese Ausgabe als quality zurück; siehe Menschliche Prüfung. Prüferinnen und Prüfer sehen die Befunde direkt neben der Übersetzung in der Queue.
Stufenfortschritt unterscheidet zwischen abgeschlossener, übersprungener, fehlgeschlagener und mit Warnungen versehener Arbeit. Menschliche Prüfung erläutert Entscheidungen und Fristen. Der Pipeline-Leitfaden erklärt, wofür sich die einzelnen Stufen eignen und wie spätere Stufen den Text früherer Stufen verändern können.