Lokalizační engine je stavové překladové API, které si na Lingo.dev vytvoříte a nakonfigurujete. Místo toho, abyste posílali řetězce do obecného LLM a doufali, že výstup splní vaše očekávání, si vytvoříte API, které konzistentně vrací přesně takové překlady, jaké očekáváte — pro každý jazyk a při každém požadavku.
Co lokalizační engine dělá#
Každý engine kombinuje pět konfigurovatelných vrstev. Když přijde požadavek na překlad, engine je všechny automaticky aplikuje — bez prompt inženýringu pro každý jednotlivý požadavek a bez ručního zásahu.
| Vrstva | Co řídí | Dokumentace |
|---|---|---|
| LLM Models | Který model zpracovává jednotlivé jazykové dvojice, včetně seřazených fallback řetězců | LLM Models → |
| Brand Voice | Jak váš produkt mluví v každém jazyce — tón, míra formálnosti, styl | Brand Voices → |
| Pravidla | Jasně definované jazykové konvence pro každý jazyk, seskupené do sad pravidel | Pravidla → |
| Glossary | Přesné mapování termínů pro každý jazyk se sémantickým párováním — nejvyšší priorita v engine | Glossaries → |
| AI Reviewers | Automatizované vyhodnocení pomocí nezávislého LLM po každém překladu | AI Reviewers → |
Konfigurace patří organizaci#
Glosáře, sady pravidel a hlasy značky patří vaší organizaci, ne jednomu konkrétnímu enginu. Engine je používá po připojení, takže stejný glosář může řídit pět enginů a jedna úprava se okamžitě promítne do všech. Konfigurace modelů zůstává navázaná na daný engine.
| Kontejner | Obsahuje | |
|---|---|---|
| Glossary | Glosář | Termíny |
| Pravidla | Sada pravidel | Pravidla |
| Brand Voice | Hlas značky | Jeden text pro každý cílový jazyk |
Smazáním enginu zůstanou všechny tři beze změny. Smazání kteréhokoli z nich systém nepovolí, dokud ho engine stále používá — nejprve ho odpojte.
Jak vrstvy spolupracují#
Engine aplikuje vrstvy v daném pořadí s jasně definovanou hierarchií priorit:
- Glosář – nejvyšší priorita. Pokud se termín z glosáře shoduje, má přednost před úsudkem modelu.
- Pravidla – střední priorita. Jazykově specifické konvence model vedou.
- Brand voice — nastavuje celkový kontext. Tón, míra formálnosti a styl pro daný jazyk.
Konfigurace modelu určuje, které LLM požadavek zpracuje, s automatickým fallbackem, pokud primární model selže. AI Reviewers běží asynchronně po dokončení překladu — nikdy neblokují odpověď.
Doplňují se, nekonkurují si
Navrhněte glosář, pravidla a hlas značky tak, aby se vzájemně doplňovaly. Glosář řeší přesné termíny, pravidla pokrývají konvence specifické pro daný jazyk a hlas značky určuje celkový tón. Pokud je termín v glosáři v rozporu s pravidlem, glosář má přednost.
Úlohy odeslané přes Async Localization API mohou také procházet přes nepovinné pipeline — AI předúpravu zdroje, lidskou kontrolu, AI následnou úpravu a kontrolu odchylky pomocí zpětného překladu.
Výchozí nastavení#
Když vytvoříte nový engine, bude předem nakonfigurovaný s výchozím nastavením modelů — primárními modely a fallbacky vybranými na základě tří let týdenního lokalizačního výzkumu, optimalizovanými pro vysokou kvalitu jak u běžných jazyků, tak u jazyků s omezenými zdroji. Většina týmů je nebude muset měnit.
Tato výchozí nastavení jsou navržená tak, aby fungovala skvěle hned od začátku. Můžete upravit jakoukoli konfiguraci modelu, změnit poskytovatele, přidat záložní varianty nebo přepsat konkrétní dvojice jazyků — výchozí nastavení ale už vychází z toho, co se nám nejlépe osvědčilo napříč stovkami jazykových dvojic. Nový engine nepoužívá žádný glosář, sadu pravidel ani hlas značky — připojte ty, které už vaše organizace má, nebo je vytvořte podle toho, jak postupně zjišťujete, co váš produkt v jednotlivých jazycích potřebuje.
Používání enginů#
Enginy jsou dostupné ve všech integracích Lingo.dev:
| Integrace | Jak se připojuje |
|---|---|
| CLI | Nastavte engineId v .lingo/config.json — každý lingo push se bude směrovat přes váš engine |
| API | Zavolejte endpoint localize se svým API klíčem — engine automaticky aplikuje všechny vrstvy |
| CI/CD | Stejná konfigurace CLI — překlady poběží přes váš engine při každém pull requestu |
| MCP | AI asistenti pro psaní kódu mohou enginy konfigurovat a používat přímo v konverzaci |
Pokud vynecháte engineId, použije se výchozí engine ve vaší organizaci.
Přehled o provozu#
Každý požadavek na překlad se zaznamenává: použitý model, spotřebované tokeny, jestli ho obsloužila záložní varianta a které termíny z glosáře a pravidla se použily. Výkon enginu sledujte v Reports a kvalitu překladu v AI hodnotitelích.
Konfigurace engine si můžete otestovat ještě před nasazením v Playground — porovnejte svůj engine se surovým modelem nebo dva enginy vedle sebe.
