Bring Your Own Engine

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Funkce BYO Engine umožňuje integraci externích strojových překladových systémů (MT) do systému Phrase, aby bylo možné je používat v překladových pracovních postupech stejně jako u jiných poskytovatelů MT.

BYO Engine je vhodný pro:

Podniky s doménově specifickými modely MT.
Poskytovatele jazykových služeb (LSP) s vlastními klientskými enginy nebo preferovanými technologiemi AI.
Organizace s interními zásadami, které vyžadují používání specifických enginů (např. Gemini, interních LLM a podobně).

Lze použít vlastní trénované BYO Engine nebo překlady směrovat do interních LLM či poskytovatelů MT, aby byla zachována plná kontrola nad kvalitou, soukromím a náklady, a přitom nadále využívat výhod překladových pamětí (TM), glosářů, QPS a CAT editoru systému Phrase.

Kde lze BYO Engine použít

Po integraci je BYO Engine k dispozici pro předpřeklad. Nakonfigurujte jej v profilu Phrase Language AI a použijte tento profil k předpřekladu z projektů Phrase TMS, portálu Phrase, projektů Phrase Strings, Phrase Studio a Phrase Language AI prostřednictvím API.

Konfigurace BYO Engine

Vytvoření adaptéru

Organizace musí vytvořit a otestovat odlehčený adaptér API. Tento adaptér umožňuje komunikaci mezi systémem Phrase a enginem.

Adaptér musí podporovat:
- Požadavky na překlad
- Podporu jazykových párů
- Kontrolu stavu enginu (Phrase odešle požadavek na stav)
Podpůrná infrastruktura (MT engine nebo LLM) musí být hostována a spravována organizací.
Systém Phrase vyžaduje oprávnění k připojení k této infrastruktuře.
Adaptér musí vracet překlady se stejným počtem segmentů a ve stejném pořadí.

Integrace BYO Engine do profilu MT

Jakmile je adaptér API implementován a nasazen, stane se BYO Engine dostupným v Phrase Language AI pro výběr v profilech MT a lze jej přiřadit k projektům.

Pro připojení BYO Engine k profilu MT:

Na stránce profilu MT v Phrase Language AI klikněte na Připojit enginy MT.

Zobrazí se stránka Připojit engine MT.
Vyberte BYO Engine.

Otevře se konfigurační stránka BYO Engine.
Zadejte URL základního enginu.
Zadejte přihlašovací údaje v závislosti na metodě ověřování (hlavička HTTP nebo přihlašovací údaje klienta (OAuth 2.0)).
Vyberte, zda chcete použít mezipaměť překladů. Standardně povoleno

Snižuje provoz a zrychluje odezvu překladu opětovným použitím segmentů přeložených během posledních 30 dnů. Toto je pouze optimalizace výkonu volání, nesnižuje náklady na překlad. Ponechte ve výchozím nastavení zapnuto, vypněte pouze během aktivního vývoje adaptéru podkladového enginu.
V případě potřeby uveďte jakékoli další informace pro engine v části Vlastní štítky.
Kliknutím na Ověřit připojení zkontrolujte, zda integrace enginu funguje.
Klikněte na Přidat.

BYO Engine je nyní k dispozici pro aktivaci v profilu.

Tip

Při používání BYO Engine neaktivujte v profilu MT žádný jiný engine. Tím zajistíte, že pro předpřeklad bude vybrán BYO Engine.

Upravit BYO Engine

Chcete-li upravit BYO Engine, klikněte na ikonu úprav na dlaždici enginu.

Odstranit BYO Engine

Chcete-li odstranit BYO Engine:

Klikněte na ikonu úprav na dlaždici enginu.
Klikněte na Odstranit BYO Engine.

ČASTÉ DOTAZY

] OTÁZKA:	Proč je požadavek na stav vyžadován? Odesílá jej Phrase do enginu, nebo se očekává, že jej bude řešit zákazník?
A	Phrase odesílá požadavek, aby ověřil, zda engine funguje či nikoli.
] OTÁZKA:	Jeden požadavek může obsahovat 500 `maxItems` v `segments`. Znamená to, že 500 zdrojových vět musí být přeloženo v reálném čase?
A	Synchronní volání zahrnují pouze až 5 segmentů, zatímco asynchronní volání mohou zahrnovat více, až 500. Časový limit pro asynchronní volání je navíc přibližně 30 minut.
] OTÁZKA:	Jsou v požadavku odesílány všechny termíny glosáře, nebo jen jejich část?
A	Odesílají se všechny termíny glosáře.
] OTÁZKA:	Je možné připojit LLM?
A	S wrapperem by to mělo být možné. Dokud engine vrací segmenty definované ve schématu, Phrase nevyžaduje konkrétní engine ani LLM.
] OTÁZKA:	Je možné vlastní hodnocení kvality (QE)?
A	QE třetích stran není podporováno.
] OTÁZKA:	Jak se zachází se značkami?
A	Obsah, který Phrase obdrží, je předem zpracován. HTML značky jsou převedeny na značky a tyto značky jsou předány tak, jak jsou.
] OTÁZKA:	Můžeme implementovat pouze asynchronní přístup? Bude to fungovat správně ve všech oblastech Phrase (předpřeklad, Editor atd.)?
A	Ne, musí být implementovány oba přístupy (ideálně všechny koncové body). Synchronní koncový bod používá například Editor, zatímco asynchronní se používá v oblastech, jako je předpřeklad.
] OTÁZKA:	Co se stane, když engine obdrží více požadavků současně?
A	BYO Engine musí být schopen toto zvládnout. Zajistěte správné zpracování souběžnosti a bezpečnosti vláken napříč všemi koncovými body, zejména těmi asynchronními.
] OTÁZKA:	Jak fungují Metadata požadavku?
A	Musí zůstat statická, jak je definováno během nastavení enginu.
] OTÁZKA:	Jak fungují Metadata segmentu?
A	V současnosti musí být součástí schématu.
] OTÁZKA:	Používá BYO Engine během zpracování MT RAG k získání kontextu?
A	Ne, BYO Engine nevyužívá RAG. Uživatelé mohou využít TM k určení, které segmenty jsou přeloženy, ale ty se v rámci samotného procesu MT nepoužívají. Je to proto, že MT enginy musí být specificky navrženy tak, aby zahrnovaly data TM prostřednictvím RAG, a ve scénářích BYO Engine neexistuje žádná kontrola nad tím, jak jsou enginy sestaveny nebo konfigurovány.

Odkaz na schéma adaptéru

Adaptér musí vracet odpovědi, které přesně odpovídají následujícím názvům polí a hodnotám výčtu. Neshoda vede k obecné chybě INTERNAL_ERROR ze strany Phrase, i když samotný adaptér vrací odpověď 200 OK.

POST /status musí vracet pole status s přísně malou hodnotou výčtu buď ok, nebo not_ok. Příklad: { \"status\": \"ok\" }
POST /languages musí vracet pole languagePairs (camelCase), přičemž každá položka obsahuje položku sourceLanguage a položku targetLanguage. Příklad: { \"languagePairs\": [ { \"sourceLanguage\": \"en\", \"targetLanguage\": \"es\" } ] }
POST /translate a GET /translateAsyncResult/{id} musí vracet položky sourceLanguage a targetLanguage na nejvyšší úrovni, a navíc pole segments, kde každý segment obsahuje položku text (zopakovaný zdrojový text) a položku translatedText. Vrácení pouze translatedText nebo použití jiného názvu klíče způsobí selhání deserializace.
POST /translateAsync vyžaduje ve své odpovědi pouze pole id. Pole status není součástí tohoto schématu odpovědi a pokud je přítomno, je ignorováno.
GET /translateAsyncStatus/{id} musí vracet pole status s použitím jedné ze tří hodnot výčtu: running pro úlohu, která se stále zpracovává, done pro úspěšně dokončenou úlohu nebo failed pro nezdařenou úlohu. U nezdařené úlohy může volitelné pole detail popsat důvod selhání. Příklad hodnot: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Popis chyby překladu\" }