Pravidlo je jedna pojmenovaná jazyková instrukce, kterou lokalizační engine použije pro cílový jazyk — například „v adresách zkracuj Straße na Str.“, ne „buď neformálnější“. Pravidla žijí v sadách pravidel: kontejnerech vlastněných organizací, které engine používá po připojení. Díky tomu může jedna sada pravidel řídit každý engine, který ji potřebuje.
Pravidla se dříve nazývala instrukce
V dashboardu se jim říká pravidla a seskupují se do sad pravidel. REST API stále zpřístupňuje jednotlivé pravidlo na /instructions a názvy jeho polí zůstávají beze změny — změnilo se jen to, kam se pravidlo zapisuje: rulesetId nahradilo ownerEngineId.
Jak to funguje#
Sada pravidel patří vaší organizaci, ne enginu. Teprve když ji k enginu připojíte, začnou se její pravidla používat — do enginu se nic nekopíruje.
| Objekt | Pole |
|---|---|
| Sada pravidel | Název, popis. Může obsahovat libovolný počet pravidel. |
| Pravidlo | Název, cílový jazyk (nebo *), text. |
Když dorazí požadavek na překlad, engine shromáždí všechna pravidla ve všech připojených sadách pravidel, jejichž cílový jazyk odpovídá hodnotě targetLocale v požadavku, a přidá je do promptu pro LLM spolu s hlasem značky a glosářem. Pravidla si nekonkurují: zahrnou se všechna odpovídající pravidla, seřazená od nejpřesnější shody jazyka, aby byla ta nejkonkrétnější vodítka na začátku.
| Pole | Popis |
|---|---|
| Název | Krátký štítek, který pravidlo identifikuje (např. „německé formální oslovování“) |
| Cílový jazyk | Jazyk, pro který toto pravidlo platí, nebo * pro všechny jazyky |
| Text | Jazykové pravidlo napsané přirozeným jazykem |
Více pravidel pro jeden jazyk
Vytvořte tolik pravidel, kolik daný jazyk potřebuje. Každé pravidlo by mělo řešit jednu věc — právě díky tomu se dá samostatně testovat, vyhodnocovat pomocí AI hodnocení pravidel a bezpečně smazat.
Sady pravidel patří organizaci#
| Akce | Důsledek |
|---|---|
| Vytvořit sadu pravidel | Existuje na úrovni organizace a nic neovlivňuje, dokud ji nepřipojíte |
| Připojit ji k enginu | Každé pravidlo v ní se použije na překlady tohoto enginu |
| Připojit ji k několika enginům | Stejná pravidla budou řídit všechny — upravíte jednou, každý engine se jimi bude řídit |
| Připojit několik sad pravidel k jednomu enginu | Všechna jejich pravidla se zkombinují |
| Odpojit ji od enginu | Engine ji přestane používat. Sada pravidel i její pravidla zůstanou zachované. |
| Smazat sadu pravidel | Dokud ji ještě používá nějaký engine, smazání bude odmítnuto — nejdřív ji odpojte. Smazáním odstraníte i její pravidla. |
| Smazat engine | Sady pravidel i pravidla zůstanou. Patří organizaci, ne enginu. |
Sady pravidel spravujete v části Pravidla v postranním panelu organizace. Na kartě Pravidla u enginu vidíte, co tento engine právě používá, a můžete tam sady pravidel připojovat nebo odpojovat.
Předdefinované instrukce#
Lingo.dev spravuje katalog hotových pravidel — jazykových konvencí pro jednotlivé jazyky, které většina týmů potřebuje, ale málokoho napadne je sepsat. Otevřete Předdefinované instrukce na kartě Pravidla u enginu a vyberte si ty, které chcete. Připojují se přímo k enginu, ne přes sadu pravidel, a kdykoli je můžete odpojit.
Kurátorovaná pravidla se v promptu řadí před ta vaše, takže pravidlo, které napíšete, základní nastavení zpřesní nebo přepíše, místo aby s ním soupeřilo.
Pravidla vs. hlas značky#
Obojí ovlivňuje výstup překladu, ale každé na jiné úrovni:
| Hlas značky | Pravidlo | |
|---|---|---|
| Rozsah | Celkový tón, styl, formálnost | Jedno konkrétní jazykové pravidlo |
| Pro každý jazyk | Jeden text pro každý jazyk, jeden hlas pro každý jazyk a engine | Více pravidel pro jeden jazyk |
| Použití | Použije se jeden nejlépe odpovídající text | Zkombinují se všechna odpovídající pravidla |
| Zástupný znak | Ano (* funguje jako výchozí hlas) | Ano (* platí pro všechny jazyky) |
| Příklad | „Používej neformální du, technický tón“ | „V adresách vždy zkracuj Straße na Str.“ |
Hlas značky použijte k tomu, abyste určili, jak váš produkt v daném jazyce mluví — formálnost, rejstřík, styl vět.
Pravidla použijte k zachycení konkrétních konvencí, které by model jinak minul — zkratek, interpunkce, formátování jednotek nebo jazykově specifických gramatických vzorců.
Fungují spolu: hlas značky nastavuje celkový projev, pravidla řeší okrajové případy.
Jak psát efektivní pravidla#
Každé pravidlo by mělo být jedna jednoznačná instrukce. Engine zahrne celý text do promptu pro LLM, takže na srozumitelnosti záleží.
Dobrá pravidla#
Always use the Oxford comma in English lists.In Japanese, use full-width parentheses （）instead of half-width ().For German addresses, abbreviate "Straße" to "Str." and
"Nummer" to "Nr."When translating percentage values for French, add a
non-breaking space before the percent sign: 42 %.Čemu se vyhnout#
- Vágním doporučením, která se překrývají s hlasem značky („buď neformálnější“) — to patří spíš do hlasu značky
- Více nesouvisejícím instrukcím v jednom pravidle — rozdělte je, aby se každá dala testovat samostatně
- Pravidlům, která jsou v rozporu s glosářem — termíny z glosáře mají v hierarchii enginu přednost
Zástupný jazyk#
Nastavte cílový jazyk na *, pokud chcete, aby se pravidlo použilo napříč všemi jazyky. Hodí se pro konvence nezávislé na jazyce:
Never translate product feature names: "Smart Compose",
"Quick Actions", "Flow Builder".Preserve Markdown formatting in all translated strings.
Keep bold (**), italic (*), and link syntax [text](url) intact.Když engine zpracovává požadavek, zahrnou se jak pravidla pro konkrétní jazyk, tak pravidla se zástupným znakem — kombinují se, nepřepisují.
Použití pravidel přes API#
Pravidla se použijí automaticky, když zavoláte endpoint localize. Engine shromáždí všechna pravidla odpovídající hodnotě targetLocale v požadavku (plus všechna pravidla *) ze sad pravidel, které engine používá. Nejsou potřeba žádné další parametry.
| Volání | Účel |
|---|---|
POST /rulesets | Vytvořit sadu pravidel pro organizaci |
GET /organizations/:id/rulesets | Vypsat sady pravidel organizace včetně počtu pravidel a enginů |
GET /rulesets/:id/rules | Vypsat pravidla v sadě pravidel |
POST /instructions with rulesetId | Přidat pravidlo do sady pravidel |
PUT /engines/:id/rulesets | Nahradit sadu sad pravidel, které engine používá |
DELETE /engines/:id/rulesets/:rulesetId | Přestat u enginu používat jednu sadu pravidel |
GET /engines/:id/instructions | Vypsat všechna pravidla, která engine právě používá |
ownerEngineId na POST /instructions stále funguje — zapisuje do vlastní sady pravidel enginu a vytvoří ji, pokud engine žádnou nemá. Doporučujeme ale rulesetId.
Přístup#
org:ruleset:read a org:ruleset:edit řídí sady pravidel a pravidla v nich; připojení jedné z nich k enginu navíc vyžaduje na daném enginu i oprávnění engine:edit. Oprávnění pro jednu konkrétní sadu pravidel dává někomu právo číst a upravovat jen tuto jednu sadu místo všech sad pravidel v organizaci. Viz Roles & Permissions.
Správa pravidel přes MCP#
Pokud používáte Lingo.dev MCP server, váš AI coding assistant může pravidla i sady pravidel vytvářet, upravovat a mazat přímo:
"Create a ruleset called German conventions and apply it to
the marketing engine.""Add a rule to that ruleset: always abbreviate Straße to Str.
in addresses.""Add a wildcard rule: never translate the term Smart Compose."