Lokalizační enginy
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.
S tímto výchozím nastavením vše dobře funguje hned od začátku. Můžete upravit libovolnou konfiguraci modelu, změnit poskytovatele, přidat záložní varianty nebo přepsat nastavení pro konkrétní jazykové dvojice — výchozí nastavení už ale vychází z toho, co se nám nejlépe osvědčilo u stovek jazykových dvojic. Nový engine nemá žádný glosář, sadu pravidel ani hlas značky. Připojte ty, které už ve své organizaci máte, naplňte je obsahem ze svého webu nebo si je vytvořte sami.
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#
U každého požadavku na překlad se zaznamenává použitý model, počet spotřebovaných tokenů, zda jej zpracovala záložní varianta a které termíny z glosáře a pravidla byly použity. Sledujte objem a kvalitu překladů v Radaru — viz Přehledy — a v sekci AI hodnotitelé nastavte kontroly pro vyhodnocení každého překladu.