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, excepto Localization, tiene su propio interruptor y guarda los cambios en cuanto lo cambias. Puedes habilitar cualquier combinación: ninguna, todas o cualquier opción intermedia. Un trabajo ejecuta las etapas en este orden:

• Pre-edit – limpia el texto de origen antes de traducir.
• Localization – el paso principal de traducción. Está marcado como Always on y no tiene interruptor.
• Rephrase – reescribe el texto para que suene natural. Es independiente de las demás etapas.
• Human review – envía el contenido a revisión interna o externa. El botón de configuración de la etapa abre Provider, Timeout y Quality threshold.
• Post-edit – armoniza la edición humana con las reglas de tu motor. No se puede activar hasta que Human review esté activado, y si desactivas Human review, esta etapa también se desactiva.
• Content length – mantiene la traducción dentro de un límite de ancho, medido en columnas de visualización en lugar de caracteres. El botón de configuración de la etapa abre Budget: Stay under a fixed limit (con una Maximum length), No longer than the original o Match the original length (con una Allowed difference, en porcentaje).
• Back-translation – verifica que el significado se conserve tras el recorrido de ida y vuelta. Es independiente de las demás etapas.

Las etapas que no están incluidas en tu plan muestran la etiqueta Enterprise y no se pueden activar.

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,
    "qualityThreshold": 85
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "contentLength": {
    "enabled": true,
    "mode": { "_tag": "fixedCap", "maxColumns": 40 }
  },
  "backTranslation": { "enabled": true }
}

Lo que controla cada campo —qué proveedor de revisión se usa, qué traducciones omiten la revisión y cuánto tiempo se espera— está documentado en la página de la propia etapa. Esta página explica 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 hace que la anulación se mantenga pequeña: la etapa que nombras se anula; la etapa que omites hereda la configuración predeterminada del motor. La solicitud anterior activa rephrase y desactiva backTranslation para este trabajo. preEdit, humanEdit, postEdit y contentLength no se nombran, 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 flexibiliza las reglas de ejecución propias de una etapa. Post-edit 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 armonizar, sin importar en qué capa lo 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.