Vai al contenuto principale

Risultati differiti

L’analisi di un invio ha due fasi:
  1. l’analisi principale produce il verdetto e i risultati della classificazione. Al suo termine, lo status dell’invio diventa done (o errored) e i risultati principali vengono inviati a webhook_url e ai tuoi webhook, come prima;
  2. 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_xai e with_llm_xai (vedi XAI – eXplainable AI) e restituite nella description delle explanations dei risultati per modello.
I risultati differiti non cambiano mai il verdetto, i risultati della classificazione né lo 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, imposta deferred_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.
La consegna è almeno una volta: la stessa notifica può arrivare più di una volta, quindi deduplicala per identifier e deferred_status. Una notifica expired può essere seguita da una seconda notifica con l’esito reale (done o errored): quella successiva sostituisce la precedente.