Přineste si vlastní nástroj

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 strojů pro strojový překlad (MT) do 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.
Poskytovatelé jazykových služeb (LSP) s vlastními klientskými nástroji nebo preferovanými AI stacky.
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 překlady mohou být směrovány do interních LLM nebo poskytovatelů MT, aby byla zachována plná kontrola nad kvalitou, soukromím a náklady, přičemž se nadále využívají výhody překladových pamětí (TM) v Phrase, glosářů, QPS a CAT editoru.

Kde lze BYO Engine použít

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

Konfigurace vlastního nástroje

Vytvoření adaptéru

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

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

Jakmile je adaptér API implementován a nasazen, vlastní nástroj 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í vlastního nástroje 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 vlastního nástroje.
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 překladovou mezipaměť. 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 povoleno ve výchozím nastavení, deaktivujte pouze v případě, že je základní adaptér nástroje 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í zkontrolujete, 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í vlastního nástroje nepovolujte v profilu MT žádný jiný nástroj. Tím zajistíte, že pro předpřeklad bude vybrán vlastní nástroj.

Editovat vlastní nástroj

Chcete-li upravit vlastní nástroj, klikněte na ikonu úprav na dlaždici nástroje.

Odstranit vlastní nástroj

Chcete-li odstranit vlastní nástroj:

Klikněte na ikonu úprav na dlaždici nástroje.
Klikněte na Odebrat vlastní nástroj.

Časté dotazy

Q:	Proč je vyžadován požadavek na stav? Odesílá jej Phrase do nástroje, 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. Časový limit pro asynchronní operace je navíc přibližně 30 minut.
Q:	Jsou v požadavku odesílány všechny termíny ze slovníku, nebo jen jejich část?
A:	Odesílají se všechny termíny ze slovníku.
Q:	Je možné připojit LLM?
A:	S obalovou vrstvou (wrapper) by to mělo být možné. Pokud nástroj vrací segmenty definované ve schématu, Phrase nevyžaduje konkrétní nástroj ani LLM.
Q:	Je možné provádět vlastní hodnocení kvality (QE)?
A:	Hodnocení kvality (QE) třetích stran není podporováno.
Q:	Jak se pracuje se značkami?
A:	Obsah, který Phrase obdrží, je předzpracován. HTML značky jsou převedeny na značky a ty jsou předány beze změny.
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 využí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 fungují metadata požadavku?
A:	Musí zůstat statická, jak je definováno během nastavení nástroje.
Q:	Jak fungují 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 v samotném procesu MT se 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. Neshoda vede k obecné chybě INTERNAL_ERROR z Phrase, i když samotný adaptér vrací odpověď 200 OK.

POST /status musí vracet pole status s přísnou hodnotou výčtu malými písmeny, 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 nejvyšší úrovně sourceLanguage a targetLanguage a navíc 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 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 úlohu, která selhala. U neúspěšné úlohy může volitelné pole detail popsat selhání. Příklad hodnot: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }