Přineste si vlastní BYO 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 integraci externích strojových překladových enginů (MT) do systému Phrase, aby bylo možné je používat v překladových pracovních postupech stejně jako jakéhokoli jiného poskytovatele MT.

BYO Engine je vhodný pro:

Podniky s doménově specifickými MT modely.
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.).

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

Kde lze BYO Engine použít

Jakmile je BYO Engine integrován, je 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 Studia a Phrase Language AI prostřednictvím API.

Konfigurace BYO Engine (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 enginu 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, 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 MT engine.

Zobrazí se stránka Připojit MT engine.
Vyberte Bring Your Own (BYO) Engine.

Otevře se stránka konfigurace 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 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.

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

Tip

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

Úprava Bring Your Own (BYO) Engine

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

Odstranit Bring Your Own (BYO) Engine

Chcete-li odstranit BYO Engine:

Klikněte na ikonu úprav na dlaždici enginu.
Klikněte na Odstranit Bring Your Own (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 podmnožina?
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	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časné době musí být součástí schématu.
OTÁZKA:	Používá BYOE během zpracování MT RAG k získání kontextu?
A	Ne, BYOE nepouží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 BYOE 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 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 chybu. Příklad hodnot: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Popis chyby překladu" }