Vlastní nástroj (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 nástrojů strojového překladu (MT) do systému Phrase, které lze používat v překladových pracovních postupech stejně jako jakéhokoli jiného poskytovatele MT.

BYO Engine je vhodný pro:

Podniky s modely MT specifickými pro danou doménu.
Poskytovatele jazykových služeb (LSP) s vlastními klientskými nástroji nebo preferovanými technologiemi umělé inteligence.
Organizace s interními zásadami, které vyžadují použití konkrétních nástrojů (např. Gemini, interní LLM atd.).

Vlastní trénované nástroje lze použít nebo lze 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 se nadále využívají výhody 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řeložení. Nakonfigurujte jej v profilu Language AI v systému Phrase a použijte tento profil k předpřeložení z projektů Phrase TMS, portálu Phrase, projektů Phrase Strings, Phrase Studio a Language AI v systému Phrase prostřednictvím API.

Konfigurace vlastního nástroje (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 nástrojem.

Adaptér musí podporovat:
- Požadavky na překlad
- Podporu jazykových párů
- Kontrolu stavu nástroje (Phrase odešle požadavek na stav)
Podpůrná infrastruktura (nástroj MT 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 nástroje do profilu MT

Jakmile je adaptér API implementován a nasazen, BYO Engine se zpřístupní 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 nástroje MT.

Zobrazí se stránka Připojit nástroj MT.
Vyberte Přinést vlastní (BYO) nástroj.

Otevře se konfigurační stránka BYO Engine.
Zadejte URL základního nástroje.
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ů. Toto je pouze optimalizace výkonu volání, nesnižuje náklady na překlad. Ponechte ve výchozím nastavení povolené, zakázat pouze v případě, že je podkladový nástroj adaptéru ve fázi aktivního vývoje.
V případě potřeby zadejte jakékoli další informace pro nástroj v části Vlastní štítky.
Kliknutím na Ověřit připojení zkontrolujte, zda integrace nástroje funguje.
Klikněte na Přidat.

Nástroj je nyní k dispozici k povolení v profilu.

Tip

Při používání BYO Engine nepovolujte v profilu MT žádný jiný nástroj. 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 upravit na dlaždici nástroje.

Odstranit BYO Engine

Chcete-li odstranit BYO Engine:

Klikněte na ikonu upravit na dlaždici nástroje.
Klikněte na Odebrat BYO Engine.

FAQ

Q:	Proč je vyžadován požadavek na stav? Je odesílán nástroji ze strany Phrase, nebo se očekává, že jej bude řešit zákazník?
A:	Phrase odesílá požadavek pro kontrolu, zda nástroj funguje či nikoliv.
Q:	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. Také časový limit pro asynchronní volání je přibližně 30 minut.
Q:	Jsou všechny termíny ze slovníku odeslány v požadavku, nebo jen jejich část?
A:	Odesílají se všechny termíny ze slovníku.
Q:	Je možné připojit LLM?
A:	Mělo by to být možné pomocí wrapperu. Dokud nástroj vrací segmenty tak, jak jsou definovány ve schématu, Phrase nevyžaduje konkrétní nástroj ani LLM.
Q:	Je možné vlastní hodnocení kvality (QE)?
A:	QE třetích stran není podporováno.
Q:	Jak se zachází se značkami?
A:	Obsah, který Phrase obdrží, je předem zpracován. Značky HTML jsou převedeny na značky a tyto značky jsou předány tak, jak jsou.
Q:	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.
Q:	Co se stane, když nástroj obdrží více požadavků současně?
A:	Nástroj 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.
Q:	Jak funguje metadata požadavku?
A:	Musí zůstat statická, jak je definováno během nastavení nástroje.
Q:	Jak funguje metadata segmentu?
A:	V současné době musí být součástí schématu.
Q:	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 samotném procesu MT nepoužívají. Je to proto, že nástroje MT 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 nástroje vytvořeny nebo nakonfigurovány.

Reference 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 (enum), aby byla zajištěna shoda. Neshoda vede k obecné chybě INTERNAL_ERROR ze strany Phrase, i když samotný adaptér vrátí odpověď 200 OK.

POST /status musí vracet pole stav s přísně malými písmeny hodnoty 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 pole sourceLanguage a pole targetLanguage. Příklad: { \"languagePairs\": [ { \"sourceLanguage\": \"en\", \"targetLanguage\": \"es\" } ] }
POST /translate a GET /translateAsyncResult/{id} musí vracet pole sourceLanguage a targetLanguage na nejvyšší úrovni, plus pole segments, kde každý segment obsahuje pole text (opakovaný 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 stav není součástí tohoto schématu odpovědi a pokud je přítomno, je ignorováno.
GET /translateAsyncStatus/{id} musí vracet pole stav s jednou ze tří hodnot výčtu: running pro zakázku, která se stále zpracovává, done pro úspěšně dokončenou zakázku nebo failed pro neúspěšnou zakázku. U neúspěšné zakázky může volitelné pole detail popsat chybu. Příklad hodnot: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }