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 a configuração de qualquer modelo, mudar de fornecedor, adicionar opções de contingência ou definir exceções para pares de idiomas específicos — mas as predefinições já refletem o que a nossa experiência mostrou funcionar melhor em centenas de pares de idiomas. Um novo motor não tem glossário, conjunto de regras nem voz da marca. Associe os que já existem na sua organização, preencha-os com base no seu site ou crie os seus.
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#
Cada pedido de tradução fica registado: o modelo utilizado, os tokens consumidos, se foi processado por uma solução alternativa e os termos do glossário e as regras aplicados. Acompanhe o volume e a qualidade das traduções no Radar — consulte Relatórios — e configure as verificações que avaliam cada tradução em Avaliadores de IA.