Saltar al contenido principal

Resultados diferidos

El análisis de un envío tiene dos fases:
  1. el análisis principal produce el veredicto y los resultados de clasificación. Cuando termina, el status del envío pasa a done (o errored) y los resultados principales se envían a webhook_url y a tus webhooks, como siempre;
  2. los resultados diferidos se producen después, sin retrasar los resultados principales. Hoy son las explicaciones impulsadas por IA de los mapas XAI y de la heatmap, solicitadas con with_xai y with_llm_xai (consulta XAI – eXplainable AI) y devueltas en la description de las explanations de los resultados por modelo.
Los resultados diferidos nunca cambian el veredicto, los resultados de clasificación ni el status del envío.

Seguimiento de los resultados diferidos

Cuando un envío tiene resultados diferidos, el resultado de la clasificación (GET /api/classification/{identifier}, GET /api/classification_video/{identifier}, GET /api/classification_audio/{identifier}) también contiene: En los vídeos, cada frame analizado en results.images tiene su propio deferred_status. Los campos no están presentes en los envíos sin resultados diferidos.
expired no es definitivo: si los resultados diferidos se completan después del plazo, deferred_status pasa a done o errored.
errored no significa que no haya ninguna explicación disponible. Cuando algunas explicaciones de los mapas XAI o de la heatmap no se pueden generar por un error técnico, deferred_status es errored y deferred_errors contiene Some explanations of the XAI maps could not be generated, mientras que las explicaciones generadas para los demás mapas se siguen devolviendo en explanations. Los mapas sin explicación permanecen en explanations con description en null; un mapa que el modelo no puede describir también tiene description null, y no es un error.

Notificación de los resultados diferidos

Para recibir una notificación cuando los resultados diferidos estén completos, establece deferred_webhook_url al enviar una imagen, un vídeo o un audio de voz (también desde URL). Funciona como webhook_url: requiere la misma habilitación y tiene las mismas restricciones de dominio y la misma autenticación. Si se omite o está vacío, no se envía ninguna notificación. También puedes activar la notificación en los webhooks configurados en el dashboard, con Notificar los resultados diferidos y una URL dedicada opcional. La notificación solo se envía a los webhooks que recibieron el resultado principal del envío: por ejemplo, un webhook que solo notifica los resultados artificiales no recibe ninguna notificación diferida para un resultado humano. La notificación se envía una sola vez, cuando los resultados diferidos pasan a done, errored o expired: no se envía para cada paso, ni cuando el análisis principal ha fallado (skipped). En un vídeo, se envía después del último frame.
La entrega es al menos una vez (at least once): la misma notificación puede llegar más de una vez, así que elimina los duplicados por identifier y deferred_status. Una notificación expired puede ir seguida de una segunda notificación con el resultado real (done o errored): la más reciente sustituye a la anterior.