Configura el pipeline

Define qué etapas del pipeline se ejecutan en dos capas: un valor predeterminado en el motor y un reemplazo opcional en una sola solicitud.

Ya decidiste qué etapas quieres alrededor del paso central de traducción. Ahora hay dos preguntas: ¿dónde vive esa decisión y qué haces cuando un trabajo necesita algo distinto al resto? La respuesta son dos capas. El motor lleva la configuración predeterminada que hereda cada trabajo asíncrono. Un objeto pipelineConfig en una sola entrega reemplaza ese valor predeterminado solo para esa entrega. Las etapas que dejes fuera del reemplazo se heredan del motor, así que una solicitud indica solo lo que cambia.

¿Es tu primera vez con el pipeline? Empieza por la Descripción general de Pipeline para ver qué hace cada etapa. Esta página trata sobre cómo activarlas y reemplazarlas, no sobre lo que hacen una vez habilitadas.

Valores predeterminados a nivel de motor#

Abre la pestaña Pipeline del motor en el panel y activa o desactiva cada etapa de forma independiente. Esa configuración es el valor predeterminado del motor: cada trabajo asíncrono que se enrute a él se ejecutará con estas etapas, salvo que una solicitud las reemplace. Configúralo una vez y no tendrás que volver a indicar el pipeline en cada llamada.

Cada etapa tiene su propio interruptor. Puedes habilitar cualquier combinación: ninguna, todas o cualquier punto intermedio:

• Edición con IA previa a la localización – limpia el texto fuente antes de traducirlo.
• Revisión humana posterior a la localización – envía el contenido a revisión Interna o Externa. En el mismo panel eliges el modo, el nivel y el tiempo de espera.
• evaluación de IA posterior a la localización – permanece deshabilitada hasta que la revisión humana esté habilitada; concilia la edición humana con las reglas de tu motor.
• Reformular para que suene natural – reescribe el texto para que se lea como nativo. Es independiente de las demás etapas.
• Verificación de retrotraducción – comprueba que el significado se conserve en el ida y vuelta. Es independiente de las demás etapas.

Localización principal no es un interruptor: siempre se ejecuta. Las etapas la rodean.

El valor predeterminado es lo que hereda cada trabajo, así que la configuración del motor es la base sobre la que se fusiona un reemplazo de pipelineConfig. Cada etapa es una clave:

{
  "preEdit": { "enabled": true },
  "humanEdit": {
    "enabled": true,
    "provider": "internal",
    "tier": "standard",
    "timeoutHours": 48
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "backTranslation": { "enabled": true }
}

Lo que controla cada campo —qué proveedor de revisión, qué nivel, cuánto tiempo espera— está documentado en la página de cada etapa. Esta página trata sobre dónde vive la configuración y cómo se combinan las dos capas.

Reemplazo por solicitud#

La mayoría de los trabajos deberían ejecutarse con el valor predeterminado del motor. La excepción es una sola entrega que necesita un pipeline distinto: un lote puntual de textos de marketing que quiere la etapa de reformulación que tu motor normalmente deja desactivada, o una carga legal que debería omitirla. Editar el motor para resolver un solo lote también cambiaría todos los demás trabajos.

Así que, en lugar de eso, pasas la diferencia en la solicitud. Agrega un objeto pipelineConfig al cuerpo de POST /jobs/localization y reemplazará el valor predeterminado del motor solo para esa entrega. Nada cambia en el motor; el siguiente trabajo sin reemplazo volverá al valor predeterminado.

{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "data": { "headline": "Ship in every language." },
  "pipelineConfig": {
    "rephrase": { "enabled": true },
    "backTranslation": { "enabled": false }
  }
}

Esta es la regla de herencia, y es lo que mantiene pequeño el reemplazo: una etapa que incluyes se reemplaza; una etapa que omites hereda el valor predeterminado del motor. La solicitud anterior activa rephrase y desactiva backTranslation para este único trabajo. preEdit, humanEdit y postEdit no se incluyen, así que se ejecutan exactamente como están configuradas en el motor. Solo indicas lo que cambia.

Dos cosas más que el reemplazo no hace, dichas claramente porque esta es la parte que parece poder hacerlo todo:

• Cambia solo esa entrega. No se escribe de vuelta en el motor, así que no sirve para hacer un cambio de configuración duradero: para eso está la pestaña Pipeline. Usa el reemplazo para algo puntual; usa la pestaña para la nueva configuración base.
• No relaja las reglas de ejecución de una etapa. evaluación de IA posterior a la localización solo se ejecuta cuando la revisión humana produjo un resultado, así que habilitar postEdit no hace nada en un trabajo que no tiene una etapa humana que conciliar, sin importar en cuál de las dos capas la hayas habilitado.

Confirma qué se ejecutó#

La configuración define qué etapas deberían ejecutarse; el propio registro del trabajo te dice cuáles sí se ejecutaron. El trabajo incluye un arreglo steps[], y ese arreglo es la forma de confirmar que un reemplazo por solicitud realmente surtió efecto, no solo que lo enviaste.

Cómo leer esos registros —el stepId de cada etapa, qué significa un paso skipped, dónde aparecen los fallos no críticos— se explica en otra página.

Siguientes pasos#

Puedes definir el valor predeterminado en el motor y reemplazarlo en una solicitud. Desde aquí, envía un trabajo que incluya un reemplazo o revisa los pasos para confirmar qué etapas se ejecutaron.