Consultar el progreso del flujo de procesamiento
Consulta el estado de las etapas, los recuentos de unidades, las advertencias y los motivos de fallo de cada destino del documento.
Consulta documents[].targets[].stages en una respuesta de tarea para saber qué está ocurriendo con un archivo y un idioma concretos. Las etapas aparecen una vez registrada la configuración del motor al inicio; hasta entonces, la matriz puede estar vacía.
Cada entrada contiene stage, status y units. Este es un fragmento del progreso:
{
"stage": "humanEdit",
"status": { "_tag": "Running" },
"units": { "finished": 3, "total": 8 }
}Aquí, tres de las ocho unidades del destino han completado la revisión humana o se la han saltado. Consulta la revisión para ver qué unidades siguen pendientes de una decisión.
Identificadores de etapa #
| Identificador | Trabajo |
|---|---|
preEdit | Pulir el texto de origen antes de traducirlo. |
localize | Generar la traducción de destino. |
rephrase | Pulir la redacción de destino. |
qualityGate | Detectar errores y, según su gravedad, decidir si hace falta una revisión humana. |
humanEdit | Esperar a la revisión interna o externa. |
postEdit | Pulir el resultado revisado. |
contentLength | Ajustar la redacción a los límites de longitud configurados. |
backTranslation | Comprobar el significado mediante traducción inversa y corrección. |
Configura las etapas en el motor. Solo se muestran las etapas habilitadas que se conservaron al iniciar la tarea.
Estado de la etapa #
status._tag | Significado y campos adicionales |
|---|---|
Pending | El trabajo aún no ha comenzado. |
Planning | El trabajo está en preparación. |
Waiting | A la espera de que termine el trabajo anterior. |
Running | El trabajo está en curso; la revisión humana puede permanecer en este estado mientras haya decisiones pendientes. |
Completed | Finalizado; incluye finishedAt. |
CompletedWithWarnings | Finalizado con advertencias que se conservan; incluye finishedAt y warnings no vacío. |
Skipped | No fue necesario ejecutar el trabajo; incluye finishedAt y reasons no vacío. |
Cancelled | El trabajo se ha detenido; incluye finishedAt y reasons no vacío. |
Failed | Fallo de la etapa; incluye finishedAt y messages no vacío. |
finishedAt es una marca de tiempo en formato ISO. units.finished indica el número de unidades completadas u omitidas, y units.total, el número de unidades del destino. Antes de preparar el documento, ambos valores pueden ser cero. Estos valores cuentan unidades de contenido: no indican el número de solicitudes al modelo, el tiempo transcurrido ni una estimación de facturación.
Decidir si aceptar un resultado #
Si falla una traducción obligatoria, el resultado afectado no puede completarse. Las etapas opcionales pueden conservar el texto anterior con advertencias. Por tanto, aunque una tarea haya finalizado, debes comprobar las advertencias de sus etapas si tu política de publicación depende de la revisión, la longitud u otro requisito de calidad.
Si se agota el tiempo de espera de la revisión humana, puede conservarse el texto generado por IA sin aprobación humana. Las etapas posteriores también pueden modificar la redacción de una persona. Lee la política de revisión y comprueba el archivo final descargado antes de publicarlo.
La API devuelve aquí el progreso. Usa la vista de ejecución de Studio para examinar los intentos del modelo y los detalles de ejecución de una etapa.