Motores de Localização
Um motor de localização é uma API de tradução com estado que cria e configura na Lingo.dev. Em vez de enviar textos para um LLM genérico e esperar que o resultado corresponda às suas expectativas, cria uma API que entrega as traduções que realmente espera — de forma consistente, em todos os idiomas, em todos os pedidos.
O que faz um motor de localização#
Cada motor combina cinco camadas configuráveis. Quando chega um pedido de tradução, o motor aplica-as automaticamente — sem prompt engineering em cada pedido, sem intervenção manual.
| Camada | O que controla | Docs |
|---|---|---|
| Modelos LLM | Que modelo processa cada par de idiomas, com cadeias de fallback ordenadas por prioridade | Modelos LLM → |
| Voz da Marca | Como o seu produto comunica em cada idioma — tom, formalidade e estilo | Vozes da Marca → |
| Regras | Convenções linguísticas específicas de cada idioma, agrupadas em conjuntos de regras | Regras → |
| Glossário | Mapeamentos exatos de termos por idioma, com correspondência semântica — prioridade máxima no motor | Glossários → |
| Avaliadores de IA | Avaliação automatizada com um LLM independente, após cada tradução | Avaliadores de IA → |
A configuração pertence à organização#
Os glossários, os conjuntos de regras e as vozes da marca pertencem à sua organização, não a um único motor. Um motor aplica-os ao ser associado a eles, por isso o mesmo glossário pode reger cinco motores e uma única edição reflete-se em todos. As configurações dos modelos continuam a pertencer ao motor.
| Contentor | Contém | |
|---|---|---|
| Glossário | Glossário | Termos |
| Regras | Conjunto de regras | Regras |
| Voz da Marca | Voz da marca | Um texto por idioma de destino |
Se eliminar um motor, os outros três elementos mantêm-se intactos. A eliminação de qualquer um deles é bloqueada enquanto um motor ainda o estiver a aplicar — desassocie-o primeiro.
Como as camadas interagem#
O motor aplica as camadas numa ordem definida, com uma hierarquia de prioridade clara:
- Glossário - precedência máxima. Se houver correspondência com um termo do glossário, este sobrepõe-se ao critério do modelo.
- Regras - precedência intermédia. As convenções linguísticas específicas de cada idioma orientam o modelo.
- voz da marca — define o contexto geral. Tom, formalidade e estilo para o idioma.
A configuração do modelo determina que LLM processa o pedido, com fallback automático se o modelo principal falhar. Os avaliadores de IA são executados de forma assíncrona depois de a tradução estar concluída — nunca bloqueiam a resposta.
Complementares, não concorrentes
Conceba o glossário, os conjuntos de regras e a voz da marca para se complementarem. O glossário trata dos termos exatos, as regras tratam das convenções específicas de cada idioma e a voz da marca define o tom geral. Se um termo do glossário entrar em conflito com uma regra, o glossário prevalece.
As tarefas submetidas através da Async Localization API também podem passar por um pipeline opcional — pré-edição por IA do texto de origem, revisão humana, pós-edição por IA e uma verificação de deriva por retrotradução.
Predefinições#
Quando cria um novo motor, este já vem pré-configurado com predefinições de modelo — modelos principais e fallbacks selecionados com base em três anos de investigação semanal em localização, otimizados para garantir qualidade tanto em idiomas comuns como em idiomas com menos recursos. A maioria das equipas não precisará de os alterar.
Estas predefinições foram pensadas para funcionar bem desde o primeiro momento. Pode editar qualquer configuração de modelo, mudar de fornecedor, adicionar fallbacks ou substituir pares de idiomas específicos — mas as predefinições já refletem o que verificámos funcionar melhor em centenas de pares de idiomas. Um novo motor não aplica qualquer glossário, conjunto de regras ou voz da marca — associe os que a sua organização já tem ou crie-os à medida que for descobrindo o que o seu produto precisa em cada idioma.
Como utilizar motores#
Os motores estão disponíveis em todas as integrações da Lingo.dev:
| Integração | Como se liga |
|---|---|
| CLI | Defina engineId em .lingo/config.json — cada lingo push passa pelo seu motor |
| API | Chame o endpoint localize com a sua chave de API — o motor aplica automaticamente todas as camadas |
| CI/CD | A mesma configuração de CLI — as traduções passam pelo seu motor em cada pull request |
| MCP | Os assistentes de programação com IA podem configurar e utilizar motores diretamente na conversa |
Se omitir engineId, será utilizado o motor predefinido da sua organização.
Observabilidade#
Todos os pedidos de tradução são registados: modelo utilizado, tokens consumidos, se foi um fallback a tratá-lo e que termos do glossário e regras foram aplicados. Acompanhe o desempenho do motor em Relatórios e a qualidade da tradução em Avaliadores de IA.
Teste as configurações do motor antes de entrarem em produção no Playground — compare o seu motor com um modelo sem configuração adicional ou compare dois motores lado a lado.