Risultati differiti
L’analisi di un invio ha due fasi:- l’analisi principale produce il verdetto e i risultati della classificazione. Al suo termine, lo
statusdell’invio diventadone(oerrored) e i risultati principali vengono inviati awebhook_urle ai tuoi webhook, come prima; - i risultati differiti vengono prodotti in seguito, senza ritardare i risultati principali. Oggi sono le spiegazioni AI delle mappe XAI e della heatmap, richieste con
with_xaiewith_llm_xai(vedi XAI – eXplainable AI) e restituite nelladescriptiondelleexplanationsdei risultati per modello.
status dell’invio.
Seguire i risultati differiti
Quando un invio ha risultati differiti, il risultato della classificazione (GET /api/classification/{identifier}, GET /api/classification_video/{identifier}, GET /api/classification_audio/{identifier}) contiene anche:
Per i video, ogni frame analizzato in
results.images ha il proprio deferred_status. I campi sono assenti negli invii senza risultati differiti.
expired non è definitivo: se i risultati differiti si completano dopo la scadenza, deferred_status diventa done o errored.errored non significa che non sia disponibile nessuna spiegazione. Quando alcune spiegazioni delle mappe XAI o della heatmap non possono essere generate a causa di un errore tecnico, deferred_status è errored e deferred_errors contiene Some explanations of the XAI maps could not be generated, mentre le spiegazioni generate per le altre mappe vengono comunque restituite in explanations. Le mappe senza spiegazione restano in explanations con description impostato a null; anche una mappa che il modello non è in grado di descrivere ha description null, e non è un errore.Notifica dei risultati differiti
Per ricevere una notifica quando i risultati differiti sono completi, impostadeferred_webhook_url quando invii un’immagine, un video o un audio vocale (anche da URL). Funziona come webhook_url: richiede la stessa abilitazione e ha le stesse restrizioni sui domini e la stessa autenticazione. Se è omesso o vuoto, non viene inviata nessuna notifica.
Puoi abilitare la notifica anche sui webhook configurati nella dashboard, con Notifica i risultati differiti e un URL dedicato opzionale. La notifica viene inviata solo ai webhook che hanno ricevuto il risultato principale dell’invio: ad esempio, un webhook che notifica solo i risultati artificiali non riceve nessuna notifica differita per un risultato umano.
La notifica viene inviata una sola volta, quando i risultati differiti diventano done, errored o expired: non viene inviata per i singoli passaggi, né quando l’analisi principale è fallita (skipped). Per un video, viene inviata dopo l’ultimo frame.