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 → |
| Instruções | Regras linguísticas distintas para idiomas específicos — testáveis e fáceis de depurar individualmente | Instruções → |
| 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 → |
Como as camadas interagem#
O motor aplica as camadas numa ordem definida, com uma hierarquia de prioridade clara:
- Glossário — prioridade máxima. Se uma regra do glossário corresponder, sobrepõe-se ao critério do modelo.
- Instruções — prioridade intermédia. Regras linguísticas específicas do 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
Estruture o glossário, as instruções e a voz da marca para se complementarem. O glossário trata dos termos exatos, as instruções tratam das regras específicas do idioma e a voz da marca define a voz global. Se um item do glossário entrar em conflito com uma instrução, 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 concebidas para funcionar bem desde o primeiro momento. Pode editar qualquer configuração de modelo, trocar de fornecedor, adicionar fallbacks ou substituir pares de idiomas específicos — mas as predefinições já refletem aquilo que verificámos funcionar melhor em centenas de pares de idiomas. A voz da marca, as instruções e o glossário começam vazios — vai adicionando cada um à medida que percebe 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 i18n.json — cada lingo.dev run 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#
Cada pedido de tradução é registado: modelo utilizado, tokens consumidos, se foi um fallback a tratá-lo e que itens do glossário e instruções foram aplicados. Monitorize o desempenho do motor em Reports 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.
