Cómo funciona
Sigue un cambio en el contenido desde su origen, pasando por las directrices de traducción guardadas, hasta obtener un resultado que puedas usar y comprobar.
Cuando escribes y revisas contenido, decides qué quieres que entienda tu público, qué necesita una explicación más detallada y qué argumentos podrían convencerlo. La traducción debe transmitir ese significado y esa intención persuasiva con la misma precisión en otro idioma. Lingo.dev utiliza modelos de lenguaje para traducir tu contenido con directrices guardadas sobre tu producto, tu terminología y tu voz.
Proporcionas el contenido de origen y los idiomas que necesitas, y seleccionas el motor de localización que debe traducirlo. Al realizar una llamada a la API, lo identificas mediante engineId; la CLI o una integración utiliza el motor de localización seleccionado en su configuración. Esa elección determina los modelos y las directrices 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 vías que configures.
Empieza por 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 proceder de un archivo, de datos estructurados de una aplicación o de un sistema de contenidos conectado. Los idiomas de origen y de destino especificados en la solicitud indican qué lenguas intervienen.
Un idioma identifica la lengua y, cuando hace falta, su región o sistema de escritura. Indica de forma explícita a qué público 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 de destino también ayudan a Lingo.dev a seleccionar las directrices de traducción aplicables. Resolución de idiomas explica esas reglas de correspondencia.
La estructura del contenido importa tanto como su idioma. Una aplicación utiliza claves de mensaje para localizar texto y variables para insertar valores. Un documento contiene encabezados, enlaces y formato. En una llamada a la API, los datos estructurados se proporcionan directamente; la CLI y los gestores de formato extraen el texto traducible de los archivos y reconstruyen sus versiones de destino. Cada vía debe devolver contenido que el sistema receptor pueda seguir utilizando.
Conserva la versión del contenido de origen junto con el resultado cuando guardes traducciones o las analices más adelante. Si quien escribe cambia el significado, una traducción correcta para la versión anterior puede dejar de transmitir el mensaje que se quiere comunicar.
Guarda el conocimiento que necesitarán las próximas solicitudes #
Un modelo de lenguaje sabe trabajar con el lenguaje. No conoce de forma automática la terminología de tu producto, los requisitos que ha acordado tu equipo ni cómo se dirige tu empresa a su público. Un motor de localización guarda los modelos elegidos y los vínculos a directrices reutilizables, para que cada solicitud pueda aprovechar ese conocimiento sin tener que enviarlo todo de nuevo.
Cada tipo de directriz responde a preguntas distintas:
- Un glosario recoge los términos, el significado que deben tener y las expresiones preferidas o 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 recoger, incluidas las distinciones de significado que el contenido traducido debe conservar.
- Una voz de marca describe cómo se dirige la empresa a su público, 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, a la vez, utilizar distintos modelos o voces cuando lo necesiten. Editar un recurso compartido puede afectar a todos los motores de localización que lo utilizan, así que comprueba a cuáles está vinculado antes de cambiar las directrices.
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 incluir format.options.context para describir el público o la finalidad, y format.options.hints para claves individuales. Así puedes guardar el conocimiento compartido en el motor de localización y explicar, a la vez, las particularidades del 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 parte de los siguientes valores predeterminados. Puedes cambiar los modelos y seleccionar directrices existentes antes de completar la creación.
| Ajuste | Valor predeterminado del formulario |
|---|---|
| Modelos | Un modelo principal recomendado y uno alternativo cubren todos los pares de idiomas. Puedes cambiar los modelos o configurar un par concreto por separado. |
| Glosarios, conjuntos de reglas y voz de marca | No 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 procesamiento | Solo traducción. Las etapas opcionales de reescritura y revisión humana están desactivadas inicialmente. |
| Puntuación del cumplimiento del glosario y las instrucciones; sugerencias | La puntuación automática, la generación de sugerencias y su aplicación automática están desactivadas inicialmente. |
Los motores de localización existentes pueden tener otros ajustes guardados. Comprueba el motor que utilizarán tus llamadas, en lugar de dar por hecho que su configuración sigue coincidiendo con los valores predeterminados. Crear y configurar un motor de localización explica la elección de modelos y la vinculación de recursos.
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 probar con su modelo alternativo. Este permite realizar otro intento; no compara ambas traducciones para elegir la que tenga la puntuación de calidad más alta.
Con la API, creas e inicias una tarea de traducción y, después, descargas las versiones de destino completadas. El resultado en JSON conserva las claves de mensaje del documento, y tu aplicación decide dónde guardarlo o utilizarlo. Con la CLI, push y pull se encargan de este flujo de trabajo con archivos. Cada integración tiene su propia forma de guardar los resultados, 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. Comprueba 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 utilizar el resultado; medir su calidad lingüística requiere otro tipo de pruebas.
Comprueba el resultado en el flujo de trabajo que lo utiliza #
Elige las mediciones en función de 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 comprobación ortográfica puede hacerse solo con el texto de destino. Las pruebas necesarias varían porque las preguntas son distintas. El resultado es útil cuando puedes ver qué se ha comprobado 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 la tarea produzca su resultado final. Consulta la política de revisión para conocer la cobertura, la asignación y lo que ocurre al agotarse el tiempo de espera: una versión de destino completada puede haberse saltado la revisión o haber seguido adelante tras agotarse ese tiempo. Las mediciones de calidad independientes se ejecutan por separado, así que completar una traducción no equivale a tener un informe de calidad terminado ni demuestra que una persona la haya aprobado.
Las mediciones también pueden examinar traducciones generadas fuera de Lingo.dev. Puedes mantener tu sistema de generación actual y consultar Medir para conocer la forma admitida de examinar sus resultados. La medición responde a una pregunta concreta sobre el texto proporcionado; tu equipo decide qué implica el resultado para su uso.
Si una revisión revela un problema recurrente de terminología, corrige la traducción actual y valora hacer, por separado, un cambio en el glosario o las instrucciones para trabajos futuros. Actualizar las directrices compartidas no reescribe todas las traducciones anteriores. Sugerencias describe cómo se gestionan los cambios propuestos en las directrices.
Para traducir contenido desde una aplicación, haz 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 con un pequeño conjunto de datos. Si tu contenido de origen ya está en archivos, el inicio rápido de la CLI sigue esa vía hasta la recuperación del resultado.