Bring Your Own Engine

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

Funkce Bring Your Own Engine (BYO Engine) umožňuje integrovat do systému Phrase externí enginy strojového překladu (MT) a používat je v překladových pracovních postupech stejně jako enginy jakéhokoli jiného poskytovatele MT.

BYO Engine je vhodný pro:

Podniky s modely MT pro konkrétní obory.
Poskytovatele jazykových služeb (LSP) s enginy přizpůsobenými klientům nebo preferovanými technologiemi AI.
Organizace s interními zásadami, které vyžadují používání konkrétních enginů (např. Gemini, interní LLM atd.).

Lze používat enginy trénované na míru nebo směrovat překlady do interních LLM či k poskytovatelům MT, a zachovat si tak plnou kontrolu nad kvalitou, ochranou soukromí a náklady a zároveň nadále využívat překladové paměti (TM), glosáře, QPS a editor CAT 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 v projektech Phrase TMS, v Phrase Portal, v projektech Phrase Strings, v Phrase Studio a v Phrase Language AI prostřednictvím API.

Konfigurace funkce Bring Your Own 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)
Základní infrastrukturu (MT engine nebo LLM) musí hostovat a spravovat organizace.
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 enginu do profilu MT

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

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 Bring Your Own (BYO) Engine.

Otevře se stránka konfigurace enginu BYO.
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ů. Ve výchozím nastavení 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ů. Jedná se pouze o optimalizaci výkonu volání, nesnižuje náklady na překlad. Ponechte ve výchozím nastavení povoleno; zakažte pouze v případě, že je základní adaptér enginu ve fázi aktivního vývoje.
V případě potřeby zadejte jakékoli další informace pro engine v části Vlastní štítky.
Kliknutím na Ověřit připojení zkontrolujete, zda integrace enginu funguje.
Klikněte na Přidat.

Engine nyní můžete v profilu povolit.

Tip

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

Úprava funkce Bring Your Own Engine

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

Odstranění funkce Bring Your Own Engine

Postup odstranění BYO Engine:

Klikněte na ikonu úprav na dlaždici enginu.
Klikněte na Odebrat Bring Your Own Engine.

Časté dotazy

D:	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?
O:	Phrase odesílá požadavek, aby ověřila, zda engine funguje, či nikoliv.
D:	Jeden požadavek může obsahovat 500 `maxItems` v `segmentech`. Znamená to, že 500 zdrojových vět musí být přeloženo v reálném čase?
O:	Synchronní i asynchronní volání přijímají 1–500 segmentů. V praxi obsahují synchronní volání z editoru jeden segment, zatímco prostřednictvím API a dávkových postupů (předpřeklad, analýza) lze odeslat více segmentů, až 500. Asynchronní tok používá stejný limit a pouze odděluje odeslání úlohy od získání výsledku. Časový limit asynchronního volání je přibližně 30 minut. Pokud váš adaptér požadavek odmítne, automaticky nepřecházíme ze synchronního na asynchronní režim. Další podrobnosti o tom, co očekávat od Phrase (počty segmentů, validační test enginu, opakování a časové limity), naleznete v příručce k BYO Engine.
D:	Jsou v požadavku odesílány všechny termíny glosáře, nebo jen jejich podmnožina?
O:	Odesílají se všechny termíny glosáře.
D:	Je možné připojit LLM?
O:	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.
D:	Je možné vlastní hodnocení kvality (QE)?
O:	QE třetích stran není podporováno.
D:	Jak se zachází se značkami?
O:	Obsah, který Phrase obdrží, je předem zpracován. Tagy HTML se převádějí na značky, které se předávají beze změny.
D:	Můžeme implementovat pouze asynchronní přístup? Bude to správně fungovat ve všech oblastech Phrase (předpřeklad, Editor atd.)?
O:	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.
D:	Co se stane, když engine obdrží více požadavků současně?
O:	Engine musí být schopen toto zvládnout. Zajistěte správné zpracování souběžných požadavků a vláknovou bezpečnost u všech koncových bodů, zejména těch asynchronních.
D:	Jak fungují metadata požadavku?
O:	Metadata požadavku, nakonfigurovaná jako vlastní štítky v konfiguraci BYO Engine, podporují dynamické zástupné symboly, které jsou vyřešeny předtím, než požadavek dorazí k adaptéru: `{project_uid}`, `{job_uid}` a `{idm_organization_uid}`. Například vlastní štítek s klíčem `project_uid` a hodnotou `{project_uid}` odešle adaptéru skutečné UID projektu Phrase TMS. Zástupné symboly se nahrazují pouze v textových hodnotách. Neznámý zástupný výraz se adaptéru předá v nezměněné podobě, aniž by se vyhodnotil.
D:	Jak fungují metadata segmentu?
O:	V současné době musí být součástí schématu.
D:	Používá BYOE během zpracování MT metodu RAG k získání kontextu?
O:	Ne, BYOE nepoužívá RAG. Uživatelé mohou využít překladové paměti k určení, které segmenty se přeloží, ale v samotném procesu MT se nepoužívají. Je to proto, že enginy strojového překladu musí být speciálně navrženy tak, aby využívaly data z překladových pamětí prostřednictvím RAG, a ve scénářích BYOE nelze ovlivnit, jak jsou enginy vytvořeny nebo nakonfigurovány.

Referenční informace o schématu 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, jehož hodnota musí být přesně ok nebo not_ok, vždy malými písmeny. Příklad: { "status": "ok" }
POST /languages musí vracet pole languagePairs (camelCase), přičemž každá položka obsahuje pole sourceLanguage a pole targetLanguage. Příklad: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate a GET /translateAsyncResult/{id} musí vracet pole nejvyšší úrovně sourceLanguage a targetLanguage a navíc pole segments, kde každý segment obsahuje pole text (zopakovaný zdrojový text) a pole 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 selhání. Příklad hodnot: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Popis selhání překladu" }