Regras

Uma regra é uma convenção linguística específica, com nome, que o engine de localização aplica a um idioma de destino — "abreviar Straße para Str. em endereços", não "ser mais casual". As regras ficam em conjuntos de regras: contêineres da organização que um engine aplica por vínculo, para que um único conjunto de regras possa orientar todos os engines que precisarem dele.

Como funciona#

Um conjunto de regras pertence à sua organização, não a um engine. É ao vinculá-lo a um engine que suas regras passam a valer — nada é copiado para dentro do engine.

Quando uma solicitação de tradução chega, o engine reúne todas as regras de todos os conjuntos de regras vinculados cujo idioma de destino corresponda ao targetLocale da solicitação e as inclui no prompt do LLM junto com a voz da marca e o glossário. As regras não competem entre si: todas as regras compatíveis são incluídas, ordenadas com o idioma mais específico primeiro, para que a orientação mais precisa venha na frente.

Os conjuntos de regras pertencem à organização#

Gerencie os conjuntos de regras em Infrastructure → Rulesets. A aba Rules de um conjunto de regras reúne as regras dele; a aba Configurações lista os engines da organização, onde você pode aplicar o conjunto de regras a um engine ou deixar de aplicá-lo. Já a aba Configurações de um engine tem uma seção Rulesets que mostra quais conjuntos ele aplica, com Add ruleset para adicionar mais um.

Regras predefinidas#

A Lingo.dev mantém um catálogo de regras prontas — convenções de idioma de que a maioria das equipes precisa e que poucas se lembram de documentar. Elas são vinculadas diretamente a um engine, sem passar por um conjunto de regras, e podem ser desvinculadas a qualquer momento.

O painel não tem uma tela para regras predefinidas. Para navegar pelo catálogo e vincular entradas, use a API ou o servidor MCP:

Cada entrada do catálogo tem um idioma de destino, um nome, uma descrição, um type (standard, convention ou preference) e um category. Entradas que compartilham um groupKey são alternativas para o mesmo idioma — um engine pode aplicar no máximo uma delas, e uma solicitação que selecionar duas será rejeitada. Vincular e desvincular exigem engine:edit no engine; qualquer pessoa com sessão iniciada pode consultar o catálogo.

As regras selecionadas entram no prompt antes das suas, então uma regra que você escrever refina ou substitui a base, em vez de disputar espaço com ela.

Regras vs. voz da marca#

Ambas moldam o resultado da tradução, mas em níveis diferentes:

Use a voz da marca para definir como seu produto se expressa em um idioma — formalidade, registro e estilo das frases.

Use regras para registrar convenções específicas que o modelo poderia deixar passar — abreviações, pontuação, formatação de unidades ou padrões gramaticais específicos de um idioma.

Elas funcionam juntas: a voz da marca define o tom, e as regras cuidam dos casos de exceção.

Como escrever regras eficazes#

Cada regra deve ser uma instrução única e sem ambiguidades. O engine inclui o texto completo no prompt do LLM, então clareza faz toda a diferença.

Boas regras#

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 %.

O que evitar#

• Orientações vagas que se sobrepõem à voz da marca ("seja mais casual") — coloque isso na voz da marca
• Várias convenções sem relação entre si em uma única regra — separe-as para que cada uma possa ser testada de forma independente.
• Regras que contradizem o glossário — os termos do glossário têm precedência na hierarquia do engine

Idioma curinga#

Defina o idioma de destino como * (Qualquer idioma no painel) para aplicar uma regra a todos os idiomas. Isso é útil para convenções independentes de idioma:

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.

Tanto as regras específicas de idioma quanto as regras curinga são incluídas quando o engine processa uma solicitação — elas se combinam, não se substituem.

Usando regras com a API#

As regras são aplicadas automaticamente quando você chama o endpoint localize. O engine reúne todas as regras que correspondem ao targetLocale da solicitação (além de quaisquer regras *) dos conjuntos de regras aplicados por ele, junto com quaisquer regras predefinidas vinculadas a ele. Nenhum parâmetro adicional é necessário.

ownerEngineId em POST /instructions ainda funciona — ele grava no próprio conjunto de regras do engine, criando um se o engine ainda não tiver nenhum. Prefira rulesetId.

Acesso#

org:ruleset:read e org:ruleset:edit controlam os conjuntos de regras e as regras dentro deles; vincular um deles a um engine também exige engine:edit nesse engine. Uma permissão por conjunto de regras dá a uma pessoa acesso de leitura e edição a um único conjunto de regras, em vez de a todos os conjuntos de regras da organização; essas permissões são definidas pela API ou pelo MCP, não pelo painel. Consulte Funções e permissões.

Gerenciando regras via MCP#

Se você usa o Lingo.dev MCP server, seu assistente de programação com IA pode criar, atualizar e excluir regras e conjuntos de regras diretamente:

"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."

"List the predefined rules for German and attach the ones
you recommend to the marketing engine."

Próximos passos#