BYO Engine

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Die BYO Engine-Funktion (BYO Engine) ermöglicht die Integration externer maschineller Übersetzung (MT) in Phrase, um sie in Übersetzungsworkflows wie jeden anderen MT-Dienstleister zu verwenden.

BYO Engine eignet sich für:

Unternehmen mit fachbereichsspezifischen MT-Modellen.
LSPs mit benutzerdefinierten Kunden-Engines oder bevorzugten KI-Stacks.
Organisationen mit internen Richtlinien, die die Verwendung spezifischer Engines erfordern (z. B. Gemini, interne LLMs usw.).

Benutzerdefinierte Engines können verwendet werden oder Übersetzungen können an interne LLMs oder MT-Dienstleister weitergeleitet werden, um die volle Kontrolle über Qualität, Datenschutz und Kosten zu behalten, während weiterhin von Phrase Translation Memories (TM), Glossaren, QPS und dem CAT Editor profitiert wird.

Wo eine BYO Engine verwendet werden kann

Nach der Integration steht eine BYO Engine für die Vorübersetzung zur Verfügung. Konfigurieren Sie sie in einem Phrase Language AI Profil und verwenden Sie dieses Profil zum Vorübersetzen aus Phrase TMS-Projekten, Phrase Portal, Phrase Strings-Projekten, Phrase Studio und Phrase Language AI über API.

Konfigurieren einer BYO Engine

Erstellen des Adapters

Die Organisation muss einen leichtgewichtigen API-Adapter erstellen und testen. Dieser Adapter ermöglicht die Kommunikation zwischen Phrase und der Engine.

Der Adapter muss Folgendes unterstützen:
- Übersetzungsanfragen
- Unterstützung von Sprachpaaren
- Statusprüfung der Engine (Phrase sendet eine Statusanfrage)
Die zugrunde liegende Infrastruktur (MT-Engine oder LLM) muss von der Organisation gehostet und gewartet werden.
Phrase benötigt Berechtigungen, um eine Verbindung zu dieser Infrastruktur herzustellen.
Der Adapter muss Übersetzungen mit der gleichen Segmentanzahl und Reihenfolge zurückgeben.

Integration der Engine in ein MT-Profil

Sobald der API-Adapter implementiert und bereitgestellt ist, steht die BYO Engine in Phrase Language AI zur Auswahl in MT-Profilen zur Verfügung und kann Projekten zugewiesen werden.

So verbinden Sie eine BYO Engine mit einem MT-Profil:

Klicken Sie auf der MT-Profilseite von Phrase Language AI auf MT-Engines verbinden.

Die Seite MT-Engine verbinden wird angezeigt.
Wählen Sie Bring Your Own (BYO) Engine aus.

Die Konfigurationsseite für die BYO Engine öffnet sich.
Geben Sie die Basis-Engine-URL ein.
Geben Sie die Anmeldeinformationen je nach Authentifizierungsmethode (HTTP-Header oder Kunden-Anmeldeinformationen (OAuth 2.0)) an.
Wählen Sie aus, ob Sie Übersetzungscache verwenden möchten. Standardmäßig aktiviert.

Reduziert den Datenverkehr und beschleunigt die Übersetzungsantwort durch Wiederverwendung von Segmenten, die innerhalb der letzten 30 Tage übersetzt wurden. Dies ist nur eine Optimierung der Aufrufleistung, die Übersetzungskosten werden dadurch nicht reduziert. Standardmäßig aktiviert lassen, nur deaktivieren, während sich der zugrunde liegende Engine-Adapter in der aktiven Entwicklung befindet.
Geben Sie bei Bedarf zusätzliche Informationen für die Engine unter Benutzerdefinierte Labels. an.
Klicken Sie auf Verbindung validieren, um zu prüfen, ob die Engine-Integration funktioniert.
Klicken Sie auf Hinzufügen.

Die Engine ist nun verfügbar, um sie im Profil zu aktivieren.

Tipp

Wenn Sie eine BYO Engine verwenden, aktivieren Sie keine andere Engine im MT-Profil. Dies stellt sicher, dass die BYO Engine für die Vorübersetzung ausgewählt ist.

BYO Engine bearbeiten

Um eine BYO Engine zu bearbeiten, klicken Sie auf das Bearbeiten-Symbol auf der Engine-Kachel.

BYO Engine löschen

So löschen Sie eine BYO Engine:

Klicken Sie auf das Bearbeiten-Symbol auf der Engine-Kachel.
Klicken Sie auf BYO Engine entfernen.

FAQ

Q:	Warum ist die Statusanfrage erforderlich? Wird sie von Phrase an die Engine gesendet oder wird erwartet, dass sie vom Kunden bearbeitet wird?
A:	Phrase sendet die Anfrage, um zu prüfen, ob die Engine funktioniert oder nicht.
Q:	Eine Anfrage kann 500 `maxItems` in `segments` enthalten. Impliziert dies, dass 500 Sätze der Ausgangssprache in Echtzeit übersetzt werden müssen?
A:	Synchrone Aufrufe enthalten nur bis zu 5 Segmente, während asynchrone Aufrufe mehr enthalten können, bis zu 500. Außerdem beträgt das asynchrone Timeout etwa 30 Minuten.
Q:	Werden alle Begriffe eines Glossars in einer Anfrage gesendet oder nur eine Teilmenge?
A:	Alle Begriffe des Glossars werden gesendet.
Q:	Ist es möglich, ein LLM anzubinden?
A:	Das sollte mit einem Wrapper möglich sein. Solange die Engine Segmente wie im Schema definiert zurückgibt, erfordert Phrase keine spezifische Engine oder LLM.
Q:	Ist eine individuelle Qualitätsbewertung (QE) möglich?
A:	QE von Drittanbietern wird nicht unterstützt.
Q:	Wie werden Tags gehandhabt?
A:	Der Content, den Phrase erhält, wird vorverarbeitet. HTML-Tags werden in Markierungen umgewandelt und diese Markierungen werden unverändert weitergegeben.
Q:	Können wir nur den asynchronen Ansatz implementieren? Wird es in allen Phrase-Bereichen (Vorübersetzung, Editor usw.) korrekt funktionieren?
A:	Nein, beide Ansätze (idealerweise alle Endpunkte) müssen implementiert werden. Der synchrone Endpunkt wird zum Beispiel vom Editor verwendet, während der asynchrone in Bereichen wie der Vorübersetzung zum Einsatz kommt.
Q:	Was passiert, wenn die Engine mehrere Anfragen gleichzeitig erhält?
A:	Die Engine muss in der Lage sein, dies zu verarbeiten. Stellen Sie eine ordnungsgemäße Handhabung von Nebenläufigkeit und Thread-Sicherheit über alle Endpunkte hinweg sicher, insbesondere bei asynchronen.
Q:	Wie funktioniert Request Metadata?
A:	Sie muss statisch bleiben, wie während des Engine-Setups definiert.
Q:	Wie funktioniert Segment Metadata?
A:	Derzeit muss sie Teil des Schemas sein.
Q:	Verwendet BYOE während der MT-Verarbeitung RAG, um Kontext abzurufen?
A:	Nein, BYOE verwendet kein RAG. Benutzer können TMs nutzen, um zu bestimmen, welche Segmente übersetzt sind, aber sie werden nicht innerhalb des MT-Prozesses selbst verwendet. Dies liegt daran, dass MT-Engines speziell dafür ausgelegt sein müssen, TM-Daten via RAG einzubinden, und bei BYOE-Szenarien gibt es keine Kontrolle darüber, wie Engines erstellt oder konfiguriert werden.

Adapter-Schema-Referenz

Der Adapter muss Antworten zurückgeben, die exakt mit den folgenden Feldnamen und Enum-Werten übereinstimmen. Ein Match-Fehler führt zu einem generischen INTERNAL_ERROR von Phrase, selbst wenn der Adapter selbst eine 200 OK-Antwort zurückgibt.

POST /status muss ein status-Feld mit einem strikten kleingeschriebenen Enum-Wert von entweder ok oder not_ok zurückgeben. Beispiel: { \"status\": \"ok\" }
POST /languages muss ein languagePairs-Array (camelCase) zurückgeben, wobei jeder Eintrag ein sourceLanguage-Feld und ein targetLanguage-Feld enthält. Example: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate und GET /translateAsyncResult/{id} müssen die übergeordneten Felder sourceLanguage und targetLanguage sowie ein segments-Array zurückgeben, wobei jedes Segment sowohl ein text-Feld (den wiederholten Ausgangssprache-Text) als auch ein translatedText-Feld enthält. Die Rückgabe von nur translatedText oder die Verwendung eines anderen Key-Namens führt zu einem Deserialisierungsfehler.
POST /translateAsync erfordert nur ein id-Feld in seiner Antwort. Ein status-Feld ist nicht Teil dieses Antwortschemas und wird ignoriert, falls es vorhanden ist.
GET /translateAsyncStatus/{id} muss ein status-Feld mit einem von drei Enum-Werten zurückgeben: running für einen Job, der noch verarbeitet wird, done für einen erfolgreich abgeschlossenen Job oder failed für einen fehlgeschlagenen Job. Für einen fehlgeschlagenen Job kann ein optionales detail-Feld den Fehler beschreiben. Beispielwerte: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }