Menschliche Prüfung in API-Jobs integrieren
Leiten Sie Übersetzungen an Bewerter weiter, verfolgen Sie ihre Entscheidungen und rufen Sie die fertigen Dokumente ab.
Fügen Sie eine menschliche Prüfung hinzu, wenn eine Übersetzung vor der Auslieferung menschliches Urteilsvermögen erfordert. Die Engine leitet jedes Dokument und jede Zielsprache an einen Entscheidungspool weiter. Bewerter genehmigen oder bearbeiten die dafür vorgesehenen Einheiten. Anschließend läuft die Pipeline weiter, bis eine Datei zum Herunterladen bereitsteht.
Beginnen Sie mit einer funktionierenden API-Übersetzung. Außerdem benötigen Sie die Tariffunktionen für die menschliche Prüfung, einen Entscheidungspool und einen Bewerter mit Zugriff auf die Übersetzungen der Engine.
Prüfung vor dem Start konfigurieren #
Öffnen Sie den Tab Pipeline der Engine und aktivieren Sie Menschliche Prüfung. Wählen Sie einen Entscheidungspool, die Sprachen und gegebenenfalls einen Verzeichnisbereich aus. Die verzeichnisbasierte Weiterleitung richtet sich nach dem Wert für key, den Sie für jedes Dokument senden. Verwenden Sie daher stabile Pfade wie emails/order-confirmation.json.
Wählen Sie Alles, um alle neu übersetzten Inhalte im Weiterleitungsbereich zur Prüfung weiterzuleiten. Die Qualitätsschranke bleibt dabei deaktiviert. Für eine gezielte Prüfung wählen Sie Streng, Mittel oder Locker. Die Qualitätsschranke listet Fehler mit Schweregraden und Kategorien auf. Die gewählte Stufe bestimmt, welche Schweregrade eine Prüfung erfordern. Auch Übersetzungen, die die Qualitätsschranke nicht kontrollieren konnte, werden zur Prüfung weitergeleitet. Die Beschreibungen finden Sie unter Stufen der Qualitätsschranke. Wiederverwendete Übersetzungen dienen als schreibgeschützter Kontext und werden nicht automatisch zu neuen Prüfungsaufgaben.
Wählen Sie ein Zeitlimit, das zum Prüfungsteam passt. Die Frist beginnt, sobald die Zielübersetzung bereit ist. Nach Ablauf der Frist können Einheiten ohne Entscheidung mit ihren bisherigen Übersetzungen weiterverarbeitet werden. Wenn jede veröffentlichte Übersetzung eine menschliche Entscheidung erfordert, muss die Freigabekontrolle Ihrer Anwendung diese Anforderung sicherstellen.
Konfigurieren Sie die Pipeline über die API, wenn die Einrichtung der Engine Teil Ihrer Anwendung ist.
Inhalte übermitteln #
Erstellen Sie den Job, laden Sie fehlende Artefakte hoch und rufen Sie /start auf. Speichern Sie die Job-ID zusammen mit der Quellrevision und der vorgesehenen Prüfungsrichtlinie. Die Pipeline-Konfiguration der Engine wird beim Start festgehalten. Spätere Änderungen wirken sich nicht auf die Prüfungsrichtlinie des laufenden Jobs aus.
Lesen Sie die Dokument-IDs und Zielsprachen des Jobs aus. humanEdit im Fortschritt der Verarbeitungsstufen der Zielübersetzung kennzeichnet Prüfungsaufgaben. Die Prüfungs-API stellt die konkreten Einheiten und Entscheidungen bereit. Ein Job kann im Zustand Running bleiben, während Bewerter daran arbeiten.
Bewertern den nötigen Kontext bereitstellen #
Bewerter können im Dashboard Warteschlange → Art → Menschliche Prüfung verwenden. Dort erscheinen die Ergebnisse der Qualitätsschranke neben der Übersetzung. Sie können Übersetzungen unverändert genehmigen oder vor dem Einreichen bearbeiten. Halten Sie Quelle, Zielsprache, Platzhalter und vorgesehene Terminologie für den Bewerter sichtbar.
Für eine Prüfungsoberfläche in Ihrer eigenen Anwendung listen Sie offene Prüfungen mit GET /v2/organizations/:orgId/localization/reviews auf. Rufen Sie anschließend die Prüfung für das ausgewählte Dokument und die ausgewählte Sprache ab. Authentifizieren Sie Entscheidungen als Bewerter mit einem persönlichen Schlüssel oder einer Benutzersitzung, nicht mit dem Organisationsschlüssel des Hintergrunddienstes.
Übermitteln Sie für erforderliche Einheiten Entscheidungen vom Typ Approved oder Edited. Bei internen Prüfungen sind Teileinreichungen möglich. Wenn Sie eine externe Prüfung übernehmen, müssen Sie für alle verbleibenden erforderlichen Einheiten gleichzeitig eine Entscheidung einreichen. Dabei können weiterhin Gebühren des Anbieters anfallen. Die Referenz zur Prüfung beschreibt die genauen Nutzdaten und Fehler.
Endergebnis abrufen und validieren #
Rufen Sie den Lokalisierungsjob auch nach der Einreichung durch einen Bewerter weiter ab. Laden Sie die Zielübersetzung erst herunter, wenn ihr Status Completed ist. Der Abschluss der Prüfung und die Fertigstellung der Datei sind voneinander getrennt, da Nachbearbeitung, Längenanpassung oder Rückübersetzung noch laufen können.
Wenn Sie genau den Wortlaut benötigen, den eine Person genehmigt hat, deaktivieren Sie spätere Umformulierungsstufen und sehen Sie sich die endgültige Ausgabe an. Wenn Sie einen Genehmigungsnachweis benötigen, kontrollieren Sie die Prüfungsentscheidungen und die Einheiten mit abgelaufener Frist. Eine abgeschlossene Stufe allein ist kein Nachweis dafür, dass eine Person jede Einheit genehmigt hat.
Veröffentlichen Sie nur, wenn die Quellrevision weiterhin übereinstimmt und die erforderliche Prüfungsrichtlinie eingehalten wurde. Eine verspätete Übersetzung darf keine Ausgabe für eine neuere Quellrevision ersetzen.
Nach Unterbrechungen fortfahren #
Behalten Sie nach einer Zeitüberschreitung auf Clientseite die ursprünglichen Job- und Prüfungs-IDs bei. Ein neuer Job startet einen separaten Übersetzungs- und Prüfungsprozess. Wenn die Antwort auf eine Entscheidung verloren geht, rufen Sie die Prüfung ab und kontrollieren Sie die gespeicherten Entscheidungen und Bewerter-IDs. Derselbe Bewerter kann eine identische Entscheidung erneut übermitteln, solange die Zielübersetzung noch Einreichungen akzeptiert. Eine abgeschlossene Zielübersetzung kann jedoch 409 zurückgeben, selbst wenn die erste Einreichung erfolgreich war. Erfolgreich übermittelte Entscheidungen sind endgültig.
Sehen Sie sich bei Ablauf einer Prüfungsfrist die angenommenen Entscheidungen, die Einheiten ohne Entscheidung und die entstandene Datei an. Bewahren Sie die bereits abgeschlossene Arbeit und wählen Sie bewusst den nächsten Schritt: die Veröffentlichung zurückhalten, eine weitere Prüfung einholen oder eine ausdrücklich definierte Ausweichlösung akzeptieren.