Regras

Uma regra é uma convenção linguística identificada que o motor de localização aplica a um idioma de destino — "abreviar Straße para Str. em moradas", e não "ser mais informal". As regras vivem em conjuntos de regras: contentores da organização que o motor aplica por associação, para que um único conjunto de regras possa orientar todos os motores que dele precisem.

Como funciona#

Um conjunto de regras pertence à sua organização, não a um motor. É ao associá-lo a um motor que as respetivas regras passam a ser aplicadas - nada é copiado para o motor.

Quando chega um pedido de tradução, o motor recolhe todas as regras de todos os conjuntos de regras associados cujo idioma de destino corresponde ao targetLocale do pedido e inclui-as no prompt do LLM, juntamente com a voz da marca e o glossário. As regras não competem entre si: todas as regras correspondentes são incluídas, ordenadas pelo idioma com melhor correspondência primeiro, para que a orientação mais específica venha à frente.

Os conjuntos de regras pertencem à organização#

Faça a gestão dos conjuntos de regras em Infrastructure → Rulesets. O separador Rules de um conjunto de regras reúne as respetivas regras; o separador Definições lista os motores da organização, onde pode aplicar o conjunto de regras a um motor ou deixar de o aplicar. Já o separador Definições de um motor inclui uma secção Rulesets que mostra o que o motor aplica, com Add ruleset para associar outro.

Regras predefinidas#

A Lingo.dev mantém um catálogo de regras prontas a usar — convenções de idioma de que a maioria das equipas precisa e que poucas se lembram de pôr por escrito. Estas são associadas diretamente a um motor, em vez de serem aplicadas através de um conjunto de regras, e podem ser removidas a qualquer momento.

O dashboard não tem um ecrã para regras predefinidas. Consulte o catálogo e associe entradas através da API ou do 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. As entradas que partilham um groupKey são alternativas para o mesmo idioma — um motor pode aplicar, no máximo, uma delas, e um pedido que selecione duas é rejeitado. Associar e remover requer engine:edit no motor; qualquer pessoa com sessão iniciada pode consultar o catálogo.

As regras selecionadas são colocadas no prompt antes das suas, para que uma regra criada por si refine ou substitua a base, em vez de entrar em conflito com ela.

Regras vs. voz da marca#

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

Use uma voz da marca para definir como o seu produto comunica num idioma - formalidade, registo, estilo de frase.

Use regras para codificar convenções específicas que, de outra forma, o modelo poderia falhar - abreviaturas, pontuação, formatação de unidades ou padrões gramaticais específicos do idioma.

Funcionam em conjunto: a voz da marca define a voz, e as regras tratam dos casos limite.

Como escrever regras eficazes#

Cada regra deve ser uma única instrução, clara e inequívoca. O motor inclui o texto completo no prompt do LLM, por isso a 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 ("be more casual") - nesse caso, coloque isso na voz da marca
• Várias convenções sem relação entre si na mesma 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 prioridade na hierarquia do motor

Idioma wildcard#

Defina o idioma de destino como * (Qualquer idioma no dashboard) para aplicar uma regra a todos os idiomas. Útil para convenções independentes da língua:

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.

As regras específicas do idioma e as regras wildcard são ambas incluídas quando o motor processa um pedido - combinam-se, não se sobrepõem.

Usar regras com a API#

As regras são aplicadas automaticamente quando chama o endpoint localize. O motor recolhe todas as regras que correspondem ao targetLocale do pedido (mais quaisquer regras *) dos conjuntos de regras aplicados pelo motor, juntamente com quaisquer regras predefinidas que lhe estejam associadas. Não são necessários parâmetros adicionais.

ownerEngineId em POST /instructions continua a funcionar - escreve no conjunto de regras do próprio motor, criando um se o motor não tiver nenhum. Dê preferência a rulesetId.

Acesso#

org:ruleset:read e org:ruleset:edit regem os conjuntos de regras e as regras dentro deles; associar um deles a um motor também requer engine:edit nesse motor. Uma permissão por conjunto de regras dá a alguém acesso de leitura e edição a um único conjunto de regras, em vez de a todos os conjuntos de regras da organização; estas permissões são definidas através da API ou do MCP, não no dashboard. Consulte Funções e permissões.

Gerir regras via MCP#

Se utilizar o servidor MCP da Lingo.dev, o seu assistente de programação com IA pode criar, atualizar e eliminar 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#