Vlastní engine (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 externí enginy strojového překladu (MT) do systému Phrase a používat je v překladových pracovních postupech stejně jako enginy jiných poskytovatelů MT.

BYO Engine je vhodný pro:

Podniky s modely MT specializovanými na konkrétní oblast.
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žití konkrétních enginů (např. Gemini, interní LLM atd.).

Lze používat enginy natré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 výhody překladových pamětí (TM), glosářů, QPS a editoru CAT systému Phrase.

Kde lze BYO Engine použít

Jakmile je BYO Engine integrován, je k dispozici pro předpřeklad. Nakonfigurujte BYO Engine v profilu Phrase Language AI a tento profil pak použijte k předpřekladu v projektech Phrase TMS a Phrase Strings, ve službách Phrase Portal a Phrase Studio a prostřednictvím rozhraní API služby Phrase Language AI.

Konfigurace vlastního enginu (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)
Podpůrná infrastruktura (MT engine nebo LLM) musí být hostována a spravována organizací.
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 dostupný ve Phrase Language AI pro výběr v profilech MT a bude jej možné přiřadit k projektům.

Chcete-li připojit BYO Engine k profilu MT:

Na stránce profilu MT ve 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 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ů. Ve výchozím nastavení povoleno.

Snižuje síťový 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 je nyní k dispozici k povolení v profilu.

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.

Upravit vlastní engine (Bring Your Own Engine)

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

Odstranit vlastní engine (Bring Your Own Engine)

Postup odstranění BYO Engine:

Klikněte na ikonu úprav na dlaždici enginu.
Klikněte na Odstranit vlastní engine (Remove Bring Your Own Engine).

ČASTÉ DOTAZY (FAQ)

D:	Proč je vyžadován požadavek na zjištění stavu? Je odesílán systémem Phrase do enginu, nebo se očekává, že jej bude řešit zákazník?
O:	Phrase odesílá požadavek za účelem kontroly, zda engine funguje či nikoliv.
D:	Jeden požadavek může v poli `segments` obsahovat až 500 položek (hodnota `maxItems`). 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 API a dávkové pracovní postupy (předpřeklad, analýza) jich mohou odeslat více, 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 lze od systému Phrase očekávat (počty segmentů, validační test enginu, opakované pokusy a časové limity), naleznete v příručce k BYO Engine.
D:	Jsou v požadavku zaslány všechny termíny glosáře, nebo jen jejich část?
O:	Jsou zaslány všechny termíny glosáře.
D:	Je možné připojit LLM?
O:	S wrapperem by to mělo být možné. Pokud 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. HTML tagy se převádějí na značky, které se beze změny předávají dál.
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 bezpečnost vláken na všech koncových bodech, zejména 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. Nahrazování zástupných symbolů se vztahuje pouze na textové hodnoty. Neznámý zástupný symbol se odešle adaptéru v nezměněné podobě, bez nahrazení.
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 k získání kontextu RAG?
O:	Ne, BYOE nepoužívá RAG. Uživatelé mohou využít TM k určení, které segmenty jsou přeloženy, 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 pomocí RAG využívaly data TM, a ve scénářích BYOE není možné ovlivnit, jak jsou enginy vytvořeny nebo nakonfigurovány.

Referenční přehled 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í přesně odpovídat jedné z hodnot výčtu psaných malými písmeny: ok nebo not_ok. 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 dále 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": "Description of translation failure" }