|
Documentación
Agenda una demoPlataforma
PlataformaMCPCLIAPI
Flujos de trabajo
GuíasRegistro de cambios

Bienvenida

  • Descripción general
  • Autenticación
  • Errores y códigos de estado
  • Firmas de webhook

Localización

  • Descripción general
  • Crear trabajos
  • Bloquea las claves no traducibles
  • Monitorear un grupo de trabajos
  • Obtener un trabajo
  • Listar trabajos
  • Entrega de webhooks
  • Progreso en tiempo real (WebSocket)

Pipeline

  • Descripción general
  • Edición con IA previa a la localización
  • Revisión humana
  • evaluación de IA (post-edición)
  • Reescribe para que suene natural
  • Verificación de retrotraducción
  • Configura el pipeline
  • Ver ejecuciones del pipeline

Aprovisionamiento

  • Descripción general
  • Crear un trabajo de aprovisionamiento
  • Tipos de fuente
  • Lo que extrae la IA
  • Entrega de webhooks
  • Progreso en vivo (WebSocket)

Síncrono

  • Localize
  • Recognize

Gestión del motor

  • Sugerencias del motor

Flujo de localización

La traducción automática es un muy buen primer paso. Para mucho contenido, con eso alcanza. Pero hay contenido que necesita algo más antes de salir: texto fuente que primero debe limpiarse de errores tipográficos, un traductor humano en el proceso, copy que suene como escrito por una persona nativa, una comprobación de que el significado sobrevivió al viaje de ida y vuelta.

Podrías sumar esos pasos por tu cuenta: llamar a traducir, pasar una revisión gramatical, enviar el resultado a una persona revisora, esperar su respuesta, traducir de vuelta para detectar desviaciones y reconciliar las diferencias. Traducir es la parte fácil. Lo difícil es orquestar las esperas, el orden y los fallos entre esos pasos; y lo más difícil de todo es una persona revisora que tarda dos días en responder.

El flujo reúne todos esos pasos, ya conectados. Cada etapa es una capa opcional alrededor del paso central de traducción, activada en el motor de localización (o sobrescrita por solicitud), y se ejecuta dentro del trabajo asíncrono persistente que ya se encarga de los reintentos y del aislamiento de fallos. Tú eliges las etapas; la plataforma las ejecuta en orden y registra lo que ocurrió. La idea central es una sola: envuelve el paso de traducción con exactamente las etapas que necesitas.

Solo API asíncrona

Las etapas del flujo solo se aplican a trabajos creados a través de la API asíncrona de localización. El endpoint sincrónico /localize ejecuta el paso central de traducción y nada más; cualquier configuración del pipeline en el motor se ignora. Una etapa de revisión humana necesita un flujo de trabajo que pueda pausarse durante dos días; una única llamada de solicitud/respuesta no tiene dónde alojar esa espera. El flujo existe donde el trabajo es persistente.

En esta página

  • Por qué usar un flujo
  • Resumen de las etapas
  • Qué ocurre con el trabajo si falla una etapa
  • Adónde ir después

Por qué usar un flujo#

Una traducción sin procesar no distingue qué tipo de contenido está traduciendo. El texto legal necesita mantenerse fiel, de forma literal, al original. El copy de marketing necesita sonar como si lo hubiera escrito una persona nativa, no como si hubiera sido traducido. El texto fuente generado por usuarios necesita que primero se limpien los errores tipográficos, antes de que un solo error en el original contamine cada idioma de destino. El contenido regulado necesita la aprobación de una persona calificada.

Son trabajos distintos, y el flujo permite que un mismo motor resuelva cualquiera de ellos combinando etapas en lugar de imponer un único comportamiento. Si no activas ninguna, obtienes traducción simple. Si activas una etapa de revisión humana, el trabajo se pausa para tu equipo. Si activas la etapa de reformulación, el resultado se reescribe para sonar nativo. Cada página de etapa a continuación indica para qué tipo de contenido sirve y, con la misma claridad, para qué contenido no sirve, para que no actives una etapa que juegue en contra de tu objetivo.

Configuras los valores predeterminados una sola vez en la pestaña Pipeline del motor, o los sobrescribes para un envío puntual con un objeto pipelineConfig en la solicitud; las etapas omitidas heredan la configuración del motor. La mecánica de ambas capas se explica en Configurar el pipeline.

Resumen de las etapas#

El flujo envuelve el paso central de localización. Puedes activar cualquier combinación de etapas, en este orden fijo. Las etapas desactivadas se omiten por completo. Cada etapa tiene su propia página con el comportamiento completo, el modo de fallo y la llamada necesaria para activarla.

1

Edición con IA previa a la localización

Opcional. Un agente de IA limpia la carga útil de origen —errores tipográficos, gramática y ortografía— antes de traducir nada, para que un solo error de origen no se propague a cada idioma de destino. No es crítica. Consulta Edición con IA previa a la localización.

2

Localización central

Siempre se ejecuta. Tu motor aplica su model config, glossary, voz de marca e instrucciones para producir la traducción. Esta es la única etapa que no puedes desactivar; todo lo demás la envuelve.

3

Revisión humana posterior a la localización

Opcional. Una persona revisa la traducción: tu propio equipo en el panel (Revisión interna) o un traductor profesional de un proveedor externo (Revisión externa). El trabajo se pausa para esperar su resultado en una espera controlada por eventos, así que una revisión larga no consume cómputo mientras espera. Consulta Revisión humana.

4

evaluación de IA posterior a la localización

Opcional, y solo se ejecuta después de que la revisión humana produce un resultado. Un agente de IA reconcilia las ediciones de la persona revisora con el glossary, la voz de marca y las instrucciones de tu motor. Esto no es lo mismo que AI Reviewers, que puntúan la calidad sin cambiar el texto. Consulta evaluación de IA.

5

Reformular para un copy natural

Opcional. Un agente de IA reescribe la traducción para que suene como copy nativo e idiomático en el idioma de destino, preservando el significado, los marcadores de posición y las etiquetas. No es crítica. Pensada para copy de marketing; omítela donde la exactitud literal sea importante. Consulta Reformular para un copy natural.

6

Verificación de retrotraducción

Opcional. El resultado se traduce de vuelta al idioma de origen, una IA lo compara con el original y la desviación se marca como minor, major o critical; los problemas graves y críticos se corrigen automáticamente. Una técnica clásica de QA humana, automatizada. Consulta Verificación de retrotraducción.

Qué ocurre con el trabajo si falla una etapa#

La objeción obvia a un flujo de seis etapas es esta: cada etapa que agregas es una cosa más que puede fallar. Entonces, ¿activarlas hace que el trabajo tenga más probabilidades de fallar? No. Un fallo en una etapa no crítica no hace fallar el trabajo. La preedición y la reformulación no son críticas: si falla cualquiera de las dos, el último resultado válido sigue adelante sin cambios y el trabajo continúa. El trabajo se degrada a un estado de advertencia en lugar de romperse, y cada etapa activada deja un registro que puedes consultar para ver exactamente qué se ejecutó.

Esa es la lógica de todo el flujo: envuelve el paso de traducción con exactamente las etapas que necesitas, ejecútalas dentro de un trabajo que ya se encarga de los fallos y consulta un registro por cada etapa. Cómo se informa un trabajo degradado, y la superficie de inspección por etapa, se explican en Observar ejecuciones del pipeline. Las páginas a continuación son las etapas en sí; empieza por la que mejor coincida con el contenido que estás traduciendo.

Adónde ir después#

Edición con IA previa a la localización
Limpia errores tipográficos y gramaticales en el texto fuente antes de traducir, para que un error de origen no llegue a todos los idiomas.
Revisión humana
Revisores internos o externos, niveles y tiempo de espera controlado por eventos: un trabajo en pausa no consume cómputo mientras espera.
evaluación de IA (posedición)
Reconcilia las ediciones de una persona revisora con tu glossary, voz de marca e instrucciones.
Reformular para un copy natural
Reescribe la traducción para que suene nativa e idiomática: para copy de marketing, no para contenido literal.
Verificación de retrotraducción
Traduce el resultado de vuelta al original, detecta desviación semántica y corrige automáticamente los problemas graves.
Configurar el pipeline
Define valores predeterminados a nivel de motor y sobrescribe etapas por solicitud con pipelineConfig.
Observar ejecuciones del pipeline
Consulta el arreglo steps por etapa, la tabla stepId y cómo completed_with_warnings informa un trabajo degradado.

¿Te resultó útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 12 días·6 min de lectura