Configurar la canalización

Define qué etapas de la canalización se ejecutan en dos capas: un valor predeterminado en el motor y una sobrescritura opcional en una sola solicitud.

Ya has decidido qué etapas quieres alrededor del paso principal de traducción. Ahora hay dos preguntas: ¿dónde vive esa decisión y qué haces cuando un trabajo necesita algo distinto del resto? La respuesta está en esas dos capas. El motor lleva el valor predeterminado que hereda cada trabajo asíncrono. Un objeto pipelineConfig en un único envío sobrescribe ese valor predeterminado solo para ese envío. Las etapas que dejes fuera de la sobrescritura se heredan del motor, así que una solicitud solo indica lo que cambia.

¿Aún no conoces la canalización? Empieza por la Descripción general de la canalización para ver qué hace cada etapa. Esta página trata de cómo activarlas y sobrescribirlas, no de 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: todos los trabajos asíncronos dirigidos a él se ejecutan con estas etapas, salvo que una solicitud las sobrescriba. Lo configuras una vez y no tienes que volver a indicar la canalización en cada llamada.

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

• Edición de IA previa a la localización – limpia el texto de origen antes de traducirlo.
• Revisión humana posterior a la localización – envía a revisión interna o externa. Eliges el modo, el nivel y el tiempo de espera en el mismo panel.
• evaluación de IA posterior a la localización – sigue desactivada hasta que se habilita la revisión humana; concilia la edición humana con las reglas de tu motor.
• Reformular para que el texto suene natural – reescribe el texto para que suene nativo. Es independiente de las demás etapas.
• Comprobación de retrotraducción – verifica que el significado se mantenga tras la ida y vuelta. Es independiente de las demás etapas.

La 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 estructura sobre la que se fusiona una sobrescritura 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 esperar— está documentado en la propia página de cada etapa. Esta página trata de dónde vive la configuración y de cómo se combinan las dos capas.

Sobrescritura por solicitud#

La mayoría de los trabajos deberían ejecutarse con el valor predeterminado del motor. La excepción es un envío concreto que necesita una canalización distinta: 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 gestionar un solo lote también cambiaría todos los demás trabajos.

Así que, en su lugar, indicas la diferencia en la solicitud. Añade un objeto pipelineConfig al cuerpo de POST /jobs/localization y sobrescribirá el valor predeterminado del motor solo para ese envío. Nada cambia en el motor; el siguiente trabajo sin sobrescritura 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ña la sobrescritura: una etapa que indicas se sobrescribe; 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 indican, así que se ejecutan exactamente como están configuradas en el motor. Solo indicas lo que cambia.

Hay dos cosas más que la sobrescritura no hace, y conviene dejarlas claras porque esta es la parte que parece que puede hacerlo todo:

• Cambia solo ese envío. No se escribe de vuelta en el motor, así que no es la forma de hacer un cambio de configuración duradero; para eso está la pestaña Pipeline. Usa la sobrescritura para algo puntual; usa la pestaña para el nuevo valor predeterminado.
• No flexibiliza 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 ha generado una salida, así que activar postEdit no hace nada en un trabajo que no tenga una etapa humana que conciliar, independientemente de la capa en la que lo hayas activado.

Confirmar lo que se ejecutó#

La configuración define qué etapas deberían ejecutarse; el propio registro del trabajo te dice cuáles se ejecutaron. El trabajo lleva una matriz steps[], y esa matriz es la forma de confirmar que una sobrescritura por solicitud realmente surtió efecto, no solo que la enviaste.

La lectura de esos registros —el stepId de cada etapa, lo que significa un paso skipped, dónde aparecen los fallos no críticos— tiene su propia página.

Siguientes pasos#

Puedes establecer el valor predeterminado en el motor y sobrescribirlo en una solicitud. A partir de aquí, envía un trabajo que incluya una sobrescritura o consulta los pasos para confirmar qué etapas se ejecutaron.