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:
{
"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 #
| Identificador | Tarea |
|---|---|
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 determinar, según su gravedad, si se requiere revisión humana. |
humanEdit | Esperar una revisión interna o externa. |
postEdit | Pulir el resultado revisado. |
contentLength | Ajustar la redacción para acercarse a los límites de longitud configurados. |
backTranslation | Verificar 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._tag | Significado y campos adicionales |
|---|---|
Pending | La tarea aún no comenzó. |
Planning | La tarea está en preparación. |
Waiting | En espera de la tarea anterior. |
Running | La tarea está en curso; la revisión humana puede permanecer en este estado mientras haya decisiones pendientes. |
Completed | Finalizada; incluye finishedAt. |
CompletedWithWarnings | Finalizada con advertencias conservadas; incluye finishedAt y un campo warnings no vacío. |
Skipped | No fue necesario ejecutar la tarea; incluye finishedAt y un campo reasons no vacío. |
Cancelled | La tarea se detuvo; incluye finishedAt y un campo reasons no vacío. |
Failed | La 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.