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:

json
{
  "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 #

IdentificadorTrabajo
preEditPulir el texto de origen antes de traducirlo.
localizeGenerar la traducción de destino.
rephrasePulir la redacción de destino.
qualityGateDetectar errores y, según su gravedad, decidir si hace falta una revisión humana.
humanEditEsperar a la revisión interna o externa.
postEditPulir el resultado revisado.
contentLengthAjustar la redacción a los límites de longitud configurados.
backTranslationComprobar 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._tagSignificado y campos adicionales
PendingEl trabajo aún no ha comenzado.
PlanningEl trabajo está en preparación.
WaitingA la espera de que termine el trabajo anterior.
RunningEl trabajo está en curso; la revisión humana puede permanecer en este estado mientras haya decisiones pendientes.
CompletedFinalizado; incluye finishedAt.
CompletedWithWarningsFinalizado con advertencias que se conservan; incluye finishedAt y warnings no vacío.
SkippedNo fue necesario ejecutar el trabajo; incluye finishedAt y reasons no vacío.
CancelledEl trabajo se ha detenido; incluye finishedAt y reasons no vacío.
FailedFallo 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.