Hlas značky určuje, jak váš produkt komunikuje—tón, míru formálnosti a styl—with one text per target locale. Patří organizaci: je to pojmenovaný kontejner, který nese variantu pro každý jazyk, který pokrývá, a po připojení se používá v lokalizačním enginu.
Jeden hlas, mnoho jazyků
Hlas značky dříve představoval text pro jediný jazyk a patřil jednomu enginu. Teď jde o jeden hlas, který obsahuje text pro každý jazyk. Enginy, které měly jeden hlas pro každý jazyk, se sloučily do jednoho hlasu s variantou pro každý jazyk—každý jazyk i každý text zůstává přesně tam, kde byl.
Jak to funguje#
| Objekt | Pole |
|---|---|
| Hlas značky | Název, popis. Obsahuje jeden text pro každý cílový jazyk. |
| Varianta | Cílový jazyk (nebo *), text hlasu. |
Když engine zpracuje požadavek pro cílový jazyk, vybere napříč všemi připojenými hlasy jedinou nejlépe odpovídající variantu a její text zahrne do promptu pro LLM—tím ovlivní volbu slov, stavbu vět i rejstřík.
Na každý požadavek se použije právě jeden text hlasu značky. Pravidla a termíny z glosáře se kombinují; hlasy značky ne.
| Pole | Popis |
|---|---|
| Cílový jazyk | Jazyk, pro který tento text platí (např. de, fr-CA, ja), nebo * pro libovolný jazyk |
| Text hlasu | Volně psané instrukce, které pro daný jazyk popisují tón, míru formálnosti a styl |
Jeden hlas pro každý jazyk v každém enginu#
Engine čte pro daný jazyk jeden hlas značky a hlídají to tři pojistky:
| Pokus | Výsledek |
|---|---|
Připojit dva hlasy, které oba obsahují text pro de | Odmítnuto (400) s uvedením překrývajících se jazyků |
Přidat text pro de do hlasu, zatímco jiný hlas na stejném enginu už pokrývá de | Odmítnuto (409) |
Přidat druhý text pro de do stejného hlasu | Odmítnuto (409) – hlas obsahuje jeden text pro každý jazyk |
Varianta * je výchozí pro každý jazyk, který nemá vlastní text. Text pro konkrétní jazyk má vždy přednost a regionální vyhodnocení funguje jako obvykle: text de-DE odpoví na obecný požadavek de. Viz Vyhodnocení jazyků.
Hlasy značky patří organizaci#
| Akce | Dopad |
|---|---|
| Vytvořit hlas značky | Existuje na úrovni organizace a nic neovlivňuje, dokud ho nepřipojíte |
| Připojit ho k enginu | Každá jeho varianta se použije pro odpovídající jazyky tohoto enginu |
| Připojit ho k několika enginům | Stejný hlas řídí všechny—upravíte ho jednou a změna se projeví ve všech enginech |
| Připojit několik hlasů k jednomu enginu | Povoleno, pokud žádné dva z nich nepokrývají stejný jazyk |
| Odpojit ho od enginu | Engine ho přestane používat. Hlas i jeho varianty zůstanou zachované. |
| Smazat hlas značky | Odmítnuto, dokud ho stále používá nějaký engine—nejdřív ho odpojte. Smazáním se odstraní i jeho varianty. |
| Smazat engine | Hlasy značky zůstanou. Patří organizaci, ne enginu. |
Hlasy spravujete v části Brand voices v postranním panelu organizace—seznam ukazuje, kolik jazyků každý hlas pokrývá a v kolika enginech se používá, a detail každého hlasu vypisuje jeho texty pro jednotlivé jazyky. Karta Brand Voice enginu zobrazuje jeden řádek pro každý jazyk a odpojuje celé hlasy.
Jak napsat text hlasu značky#
Text hlasu je volně formulovaný přirozený jazyk. Pište ho, jako byste dávali zadání překladateli, který s vaším produktem nikdy nepracoval.
Efektivní hlas značky obvykle zahrnuje:
- Úroveň formálnosti – formální „Sie“ vs. neformální „du“ v němčině, „vous“ vs. „tu“ ve francouzštině
- Tón – profesionální, konverzační, hravý, technický
- Cílové publikum – vývojáři, firemní zákazníci, spotřebitelé, interní týmy
- Konvence – jak pracovat s čísly, daty, měnami nebo produktovou terminologií
Příklad#
Pro německý jazyk zaměřený na vývojáře:
Use informal "du" address. Keep a direct, technical tone - similar
to how Stripe or Vercel write their German documentation. Prefer
short sentences. Use active voice. When a German equivalent exists
for a technical term, use it (e.g., "Bereitstellung" for deployment),
but keep widely-adopted English terms as-is (e.g., API, CLI, Token).Název a popis kontejneru nechte pro lidi—pomáhají hlas identifikovat v seznamu organizace a vysvětlují, k čemu slouží. K modelu se dostane pouze text varianty.
Použití hlasu značky s API#
Hlasy značky se použijí automaticky, když zavoláte localize endpoint. Engine porovná targetLocale v požadavku s variantami všech připojených hlasů a do promptu zahrne nejlepší shodu. Žádné další parametry nejsou potřeba.
{
"sourceLocale": "en",
"targetLocale": "de",
"data": {
"greeting": "Hey there! Ready to ship?",
"cta": "Get started"
}
}S výše uvedeným německým textem bude engine vytvářet neformální, technicky zaměřené překlady místo obecných formálních výstupů.
| Volání | Účel |
|---|---|
POST /brand-voices | Vytvořit hlas pro organizaci |
GET /organizations/:id/brand-voices | Vypsat hlasy organizace s počty jazyků a enginů |
GET /brand-voices/:id/variations | Vypsat texty hlasu pro jednotlivé jazyky |
POST /brand-voice-variations s brandVoiceId | Přidat text pro jeden jazyk |
PUT /brand-voice-variations/:id | Změnit text nebo ho přesunout do jiného jazyka |
PUT /engines/:id/brand-voices | Nahradit sadu hlasů, které engine používá |
DELETE /engines/:id/brand-voices/:brandVoiceId | Přestat v enginu používat jeden hlas |
GET /engines/:id/brand-voice-variations | Vypsat všechny jazykové texty, které engine aktuálně používá |
POST /brand-voices stále přijímá targetLocale a text společně a založí první variantu hlasu, a ownerEngineId stále přidává do hlasu, který engine už používá—případně ho vytvoří a použije, pokud žádný neexistuje.
Přístup#
org:brandvoice:read a org:brandvoice:edit řídí hlasy a jejich varianty; připojení hlasu k enginu navíc na tomto enginu vyžaduje také engine:edit. Oprávnění pro jednotlivý hlas někomu umožní číst a upravovat jeden konkrétní hlas místo všech hlasů v organizaci. Viz Role a oprávnění.
Správa hlasu značky přes MCP#
Pokud používáte Lingo.dev MCP server, váš AI coding assistant může vytvářet a aktualizovat hlas značky přímo v konverzaci:
"Create a brand voice called Product voice and apply it to the
docs engine.""Set its German text to informal du, technical tone, short
sentences, active voice."