Consultar el progreso del flujo de procesamiento

Consulta el estado de cada etapa, la cantidad de unidades, las advertencias y los motivos de falla de cada documento de destino.

Consulta documents[].targets[].stages en una respuesta de trabajo para saber qué está pasando con un archivo y un idioma. Las etapas aparecen una vez que se registra la configuración del motor al inicio; antes de ese momento, el arreglo puede estar vacío.

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 ya completaron la revisión humana o la omitieron. Consulta la revisión para ver qué unidades aún requieren una decisión.

Identificadores de etapa #

IdentificadorTarea
preEditPulir el texto de origen antes de traducirlo.
localizeGenerar la traducción de destino.
rephrasePulir la redacción de destino.
qualityGateDetectar errores y determinar, según su gravedad, si se requiere revisión humana.
humanEditEsperar una revisión interna o externa.
postEditPulir el resultado revisado.
contentLengthAjustar la redacción para acercarse a los límites de longitud configurados.
backTranslationVerificar 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 el trabajo.

Estado de la etapa #

status._tagSignificado y campos adicionales
PendingLa tarea aún no comenzó.
PlanningLa tarea está en preparación.
WaitingEn espera de la tarea anterior.
RunningLa tarea está en curso; la revisión humana puede permanecer en este estado mientras haya decisiones pendientes.
CompletedFinalizada; incluye finishedAt.
CompletedWithWarningsFinalizada con advertencias conservadas; incluye finishedAt y un campo warnings no vacío.
SkippedNo fue necesario ejecutar la tarea; incluye finishedAt y un campo reasons no vacío.
CancelledLa tarea se detuvo; incluye finishedAt y un campo reasons no vacío.
FailedLa etapa falló; incluye finishedAt y un campo messages no vacío.

finishedAt es una marca de tiempo en formato ISO. units.finished indica la cantidad de unidades completadas u omitidas, y units.total indica la cantidad de unidades del destino. Antes de preparar el documento, ambos valores pueden ser cero. Estas cifras corresponden a unidades de contenido, no a solicitudes al modelo, tiempo transcurrido ni una estimación de facturación.

Decidir si se acepta 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 eso, aunque un trabajo haya finalizado, debes revisar 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, el texto generado por IA puede conservarse 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 verifica el archivo final descargado antes de publicarlo.

Aquí, la API devuelve el progreso. Usa la vista de ejecución de Studio para investigar los intentos del modelo y los detalles de ejecución de una etapa.