Un motor de localización es una API de traducción con estado que creas y configuras en Lingo.dev. En lugar de enviar cadenas a un LLM genérico y confiar en que el resultado esté a la altura de tus expectativas, creas una API que genera justo las traducciones que esperas, de forma coherente, en cada idioma y en cada solicitud.
Qué hace un motor de localización#
Cada motor combina cinco capas configurables. Cuando llega una solicitud de traducción, el motor las aplica todas automáticamente, sin necesidad de hacer prompt engineering en cada petición ni de intervención manual.
| Capa | Qué controla | Documentación |
|---|---|---|
| Modelos LLM | Qué modelo se encarga de cada par de idiomas, con cadenas de fallback priorizadas | Modelos LLM → |
| Voz de marca | Cómo habla tu producto en cada idioma: tono, formalidad y estilo | Voces de marca → |
| Reglas | Convenciones lingüísticas específicas de cada idioma, agrupadas en conjuntos de reglas | Reglas → |
| Glosario | Correspondencias exactas de términos por idioma, con coincidencia semántica: la máxima prioridad del motor | Glossaries → |
| Evaluadores de IA | Evaluación automatizada con un LLM independiente tras cada traducción | AI Reviewers → |
La configuración pertenece a la organización#
Los glosarios, los conjuntos de reglas y las voces de marca pertenecen a tu organización, no a un único motor. Un motor los aplica al asociarlos, así que un mismo glosario puede regir cinco motores y un solo cambio se refleja en todos. Las configuraciones de modelo siguen perteneciendo al motor.
| Contenedor | Contiene | |
|---|---|---|
| Glosario | Glosario | Términos |
| Reglas | Conjunto de reglas | Reglas |
| Voz de marca | Voz de marca | Un texto por cada idioma de destino |
Si eliminas un motor, los otros tres permanecen intactos. No se permite eliminar ninguno de ellos mientras un motor lo siga aplicando: primero, desvincúlalo.
Cómo interactúan las capas#
El motor aplica las capas en un orden definido, con una jerarquía de prioridad clara:
- Glosario - máxima prioridad. Si coincide un término del glosario, prevalece sobre el criterio del modelo.
- Reglas - prioridad media. Las convenciones lingüísticas específicas de cada idioma guían al modelo.
- Voz de marca - marca el contexto general. Tono, formalidad y estilo para el idioma.
La configuración del modelo determina qué LLM procesa la solicitud, con fallback automático si falla el modelo principal. Los evaluadores de IA se ejecutan de forma asíncrona una vez completada la traducción; nunca bloquean la respuesta.
Complementarias, no excluyentes
Diseña el glosario, las reglas y la voz de marca para que se complementen. El glosario se ocupa de los términos exactos, las reglas de las convenciones específicas de cada idioma y la voz de marca define el tono general. Si un término del glosario entra en conflicto con una regla, prevalece el glosario.
Los trabajos enviados mediante la API de localización asíncrona también pueden pasar por un pipeline opcional: preedición con IA del texto fuente, revisión humana, posedición con IA y una comprobación de deriva mediante retrotraducción.
Valores predeterminados#
Cuando creas un motor nuevo, viene preconfigurado con valores predeterminados del modelo: modelos principales y fallbacks seleccionados a partir de tres años de investigación semanal en localización, optimizados para ofrecer calidad tanto en idiomas comunes como en idiomas con menos recursos. La mayoría de los equipos no necesitarán cambiarlos.
Estos valores predeterminados están diseñados para funcionar bien desde el primer momento. Puedes editar cualquier configuración de modelo, cambiar de proveedor, añadir alternativas de respaldo o sobrescribir pares de idiomas concretos, pero los valores predeterminados ya reflejan lo que hemos comprobado que mejor funciona en cientos de pares de idiomas. Un motor nuevo no aplica ningún glosario, conjunto de reglas ni voz de marca: asocia los que tu organización ya tenga o créalos a medida que descubres lo que necesita tu producto en cada idioma.
Uso de los motores#
Puedes acceder a los motores desde todas las integraciones de Lingo.dev:
| Integración | Cómo se conecta |
|---|---|
| CLI | Configura engineId en .lingo/config.json - cada lingo push pasa por tu motor |
| API | Llama al endpoint localize con tu clave de API: el motor aplica automáticamente todas las capas |
| CI/CD | La misma configuración de CLI: las traducciones pasan por tu motor en cada pull request |
| MCP | Los asistentes de programación con IA pueden configurar y usar motores directamente desde la conversación |
Si omites engineId, se utilizará el motor predeterminado de tu organización.
Observabilidad#
Cada solicitud de traducción queda registrada: qué modelo se ha utilizado, cuántos tokens se han consumido, si la ha gestionado una alternativa de respaldo y qué términos del glosario y reglas se han aplicado. Supervisa el rendimiento del motor en Informes y la calidad de la traducción en Evaluadores de IA.
Prueba las configuraciones del motor antes de ponerlas en producción en el Playground: compara tu motor con un modelo sin configurar o compara dos motores en paralelo.
