Cómo funciona

Sigue un cambio en el contenido desde su origen, pasando por las pautas de traducción guardadas, hasta obtener un resultado que puedas usar y verificar.

Cuando escribes y revisas contenido, decides qué quieres que tus lectores entiendan, qué necesita más explicación y qué argumentos podrían convencerlos. La traducción debe transmitir ese significado y esa intención persuasiva con la misma precisión en otro idioma. Lingo.dev usa modelos de lenguaje para traducir tu contenido con pautas guardadas sobre tu producto, tu terminología y tu voz.

Proporcionas el contenido de origen y los idiomas que necesitas, y eliges el motor de localización que lo traducirá. Quien hace la solicitud a la API lo identifica con engineId; la CLI o una integración usa el motor de localización seleccionado en su configuración. Esa elección determina los modelos y las pautas compartidas disponibles para la solicitud. El contenido traducido se devuelve a través de la herramienta que lo solicitó, mientras que las mediciones de calidad y la revisión humana siguen las rutas que configures.

Comienza con el contenido y su idioma de destino #

El contenido que proporcionas es el origen. Cada versión traducida es un destino. El contenido de origen puede venir de un archivo, de datos estructurados en una aplicación o de un sistema de contenido conectado. Los idiomas de origen y destino solicitados indican qué idiomas intervienen en la traducción.

Un idioma identifica la lengua y, cuando hace falta, su región o sistema de escritura. Define explícitamente el público al que te diriges: una solicitud de pt-BR especifica portugués de Brasil, en lugar de dejar la región sin definir. Los idiomas de origen y destino también ayudan a Lingo.dev a seleccionar las pautas de traducción aplicables. Resolución de idiomas explica esas reglas de coincidencia.

La estructura del contenido importa tanto como su idioma. Una aplicación usa claves de mensajes para encontrar texto y variables para insertar valores. Un documento contiene encabezados, enlaces y formato. Quien hace la solicitud a la API proporciona datos estructurados directamente; la CLI y los controladores de formato extraen el texto traducible de los archivos y reconstruyen sus versiones de destino. Cada ruta debe devolver contenido que el sistema receptor pueda seguir usando.

Conserva la versión del contenido de origen junto con el resultado cuando guardes traducciones o las analices más adelante. Si quien creó el contenido cambia su significado, una traducción correcta para la versión anterior puede dejar de expresar el mensaje previsto.

Guarda el conocimiento que necesitarán las próximas solicitudes #

Un modelo de lenguaje sabe trabajar con el lenguaje. Pero no conoce automáticamente la terminología de tu producto, los requisitos acordados por tu equipo ni cómo se comunica tu empresa con sus lectores. Un motor de localización guarda la selección de modelos y los vínculos a pautas reutilizables, para que cada solicitud pueda aprovechar ese conocimiento sin tener que enviarlo todo de nuevo.

Cada tipo de pauta responde a preguntas distintas:

  • Un glosario registra términos, su significado previsto, las expresiones preferidas y los nombres que deben dejarse sin traducir. Ayuda al modelo a distinguir un concepto del producto de otros usos de la misma palabra.
  • Un conjunto de reglas contiene instrucciones de traducción. Permite expresar requisitos recurrentes que una lista de términos no puede cubrir, incluidas las distinciones de significado que el contenido traducido debe conservar.
  • Una voz de marca describe cómo se comunica la empresa con sus lectores, incluidos el tono y el grado de formalidad.

Los glosarios, los conjuntos de reglas y las voces de marca pertenecen a tu organización y pueden vincularse a varios motores de localización. Los flujos de trabajo relacionados pueden compartir terminología y mantener distintas selecciones de modelos o voces cuando lo necesiten. Editar un recurso compartido puede afectar a todos los motores de localización que lo usan, así que revisa a cuáles está vinculado antes de cambiar las pautas.

Para cada solicitud, Lingo.dev selecciona los términos pertinentes del glosario, las instrucciones aplicables, una variante de voz y los modelos candidatos del motor de localización elegido. Un documento JSON también puede proporcionar format.options.context para describir el público o el propósito, y format.options.hints para claves individuales. Así puedes conservar el conocimiento compartido en el motor de localización y explicar qué tiene de particular el contenido que se está traduciendo. Contexto de traducción explica estas opciones en detalle.

Valores predeterminados del formulario de creación #

El formulario de creación de la aplicación web usa los siguientes valores predeterminados. Puedes cambiar los modelos y seleccionar pautas existentes antes de completar la creación.

ConfiguraciónValor predeterminado del formulario
ModelosUn modelo principal recomendado y uno de respaldo cubren todos los pares de idiomas. Puedes cambiar los modelos o configurar un par específico por separado.
Glosarios, conjuntos de reglas y voz de marcaNo se selecciona ningún recurso para vincular de forma predeterminada. Selecciona recursos existentes durante la creación o vincúlalos más adelante.
Secuencia de procesamientoSolo traducción. Las etapas opcionales de reescritura y revisión humana están desactivadas al inicio.
Puntuación del cumplimiento del glosario y las instrucciones; sugerenciasLa puntuación automática, la generación de sugerencias y su aplicación automática están desactivadas al inicio.

Los motores de localización existentes pueden tener distintas configuraciones guardadas. Revisa el motor que se usará para la solicitud, en lugar de suponer que su configuración aún coincide con los valores predeterminados. Crear y configurar un motor de localización explica la selección de modelos y los recursos vinculados.

Genera la versión de destino y devuélvela a quien la solicitó #

El modelo de lenguaje seleccionado recibe el contenido de origen y el contexto aplicable. Si el primer modelo configurado no puede completar la solicitud, el motor de localización puede intentarlo con su modelo de respaldo. El modelo de respaldo permite hacer otro intento; no compara ambas traducciones ni elige la que tenga la puntuación de calidad más alta.

Con la API, creas e inicias un trabajo de traducción y luego descargas las versiones de destino completadas. El resultado JSON conserva las claves de mensajes del documento, y tu aplicación decide dónde guardarlo o usarlo. Con la CLI, los comandos push y pull se encargan de este flujo de trabajo con archivos. Cada integración tiene su propia forma de escribir los resultados en el sistema de origen, como abrir una solicitud de incorporación de cambios con las traducciones. Integraciones explica qué lee y escribe cada conexión.

La estructura devuelta conecta la traducción con el resto de tu trabajo. Verifica que la aplicación pueda cargar el catálogo, sustituir sus variables o mostrar los enlaces y el formato del documento. Estas comprobaciones confirman que el sistema receptor puede usar el resultado; medir su calidad lingüística requiere otro tipo de evidencia.

Verifica el resultado en el flujo de trabajo que lo usa #

Elige las mediciones según lo que importa en tu contenido. Para comprobar que se conserva el significado, necesitas el contenido de origen y su traducción, con suficiente contexto para entender la intención de quien lo escribió. Una revisión ortográfica puede hacerse solo con el texto de destino. La evidencia cambia porque las preguntas son distintas. El resultado es útil cuando puedes ver qué se comprobó y examinar el fragmento en el que se basa la respuesta.

La secuencia de procesamiento del motor puede incluir una revisión humana antes de que el trabajo produzca su resultado final. Consulta la política de revisión para conocer la cobertura, el enrutamiento y qué ocurre cuando se agota el tiempo de espera: una versión de destino completada puede haberse saltado la revisión o haber continuado después de ese límite. Las mediciones de calidad independientes se ejecutan por separado, así que completar una traducción no equivale a tener un informe de calidad completo ni demuestra que una persona la haya aprobado.

Las mediciones también pueden examinar traducciones producidas fuera de Lingo.dev. Puedes conservar tu sistema de generación actual y consultar Medir para conocer el método disponible para inspeccionar sus resultados. La medición responde a una pregunta definida sobre el texto proporcionado; tu equipo decide qué implica ese resultado para su uso.

Si una revisión revela un problema recurrente de terminología, corrige la traducción actual y considera hacer, por separado, un cambio en el glosario o las instrucciones para futuros trabajos. Actualizar las pautas compartidas no reescribe todas las traducciones anteriores. Sugerencias describe cómo se gestionan los cambios propuestos en las pautas.

Para traducir contenido de una aplicación, realiza tu primera solicitud a la API. La guía recorre la configuración, la traducción y la inspección de un archivo de destino guardado usando un pequeño conjunto de datos. Si tu contenido de origen ya está en archivos, la guía de inicio rápido de la CLI recorre ese proceso hasta recuperar los resultados.