Revisione manuale
La coda di revisione (HIL — Human-in-the-Loop) contiene i documenti per cui la confidence dell'AI è insufficiente per un processamento automatico. Un operatore esamina i dati estratti a confronto con il PDF originale e approva o rigetta il documento.
La coda di revisione
La coda mostra tutti i documenti in attesa di revisione manuale, ordinabile cliccando le intestazioni.
Colonne:
- File — nome del PDF
- Confidence — badge con la percentuale di certezza media
- Semaforo — GREEN / YELLOW / RED
- Caricato — data e ora di ricezione
- Operatore —
liberose nessuno sta lavorando sul documento, oppure l'email del collega che ha preso in carico - Azioni — bottone Revisiona
Come revisionare un documento
1. Prendi in carico il documento
Clicca Revisiona nella riga della coda, poi Prendi in carico nella pagina di dettaglio.
Il documento viene riservato a te per 30 minuti. Durante questo tempo altri operatori vedranno il tuo nome nella colonna Operatore e non potranno modificarlo.
2. Confronta i dati con il PDF
La pagina affianca il PDF originale e la tabella dei campi estratti. Il PDF è navigabile direttamente in pagina (zoom, scroll).
Evidenziazione bidirezionale sul PDF:
- Clicca su una cella (intestazione o riga): il valore viene evidenziato nel PDF
- Clicca su del testo nel PDF: il sistema mostra i campi che corrispondono a quella porzione
L'evidenziazione usa il text-layer del PDF: è istantanea sui PDF digitali, e richiede pochi secondi in più sui PDF scansionati.
3. Correggi i dati se necessario
I campi della tabella sono editabili — clicca su una cella e modifica il valore. I campi con bassa confidence sono evidenziati in giallo. Presta attenzione ai campi obbligatori (spesso marcati REQ).
4. Approva o Rigetta
Approvare: clicca Approva. Il documento passa in stato completato, il CSV/JSON diventa disponibile e il webhook order.processed viene inviato ai sistemi integrati.
Rigettare: compila il campo Motivo rigetto e clicca Rigetta. Usa il rigetto quando il documento è illeggibile o i dati non possono essere corretti. Un documento rigettato non genera webhook.
Migliora con una direttiva al vendor
Se l'AI sbaglia sistematicamente un campo per un certo fornitore (es. "Order qty." letto come riferimento anziché quantità), puoi insegnare al sistema una regola una volta sola e applicarla automaticamente ai prossimi documenti dello stesso vendor.
Nella pagina di revisione, sotto la barra "Prendi in carico", trovi il blocco NUOVO — Migliora con una direttiva al vendor (visibile solo se la feature è attiva per il tuo tenant e il documento ha un vendor riconosciuto).
Come funziona
- Apri il blocco e scrivi la regola con parole tue. Esempi:
- "La colonna 'Order qty.' è la quantità ordinata"
- "Il codice articolo si trova nella colonna più a destra, seconda riga"
- Clicca Riapplica con questa direttiva. Aspetta 30–60 secondi: il sistema re-estrae il documento applicando la regola.
- Vedi il risultato:
- Se ti convince, clicca Approva come al solito. La direttiva viene memorizzata e applicata automaticamente ai prossimi documenti dello stesso vendor.
- Se non ti convince, clicca Annulla preview. Torni alle righe di prima e puoi scrivere una direttiva diversa.
Cose da sapere
- Niente è permanente finché non clicchi Approva. Puoi sperimentare quanto vuoi.
- Se avevi già fatto correzioni manuali, il sistema ti avvisa prima di sovrascriverle.
- Più sei specifico, meglio funziona. "estrai dalla colonna a destra, seconda riga" è più utile di "fai meglio".
- Lingua libera (italiano colloquiale o tecnico). Il modello capisce.
Dove vedere e gestire le direttive salvate
Nella pagina Schema → Vendors → [nome fornitore] trovi:
- La regola attiva (cosa il sistema usa oggi sui prossimi documenti)
- Le direttive scritte dagli operatori (storico di tutte le direttive, con autore, data, testo)
- La storia delle versioni della regola
Da lì puoi anche eliminare una direttiva se nel tempo non funziona più. L'eliminazione avrà effetto alla prossima Riapplica su un documento di quel vendor.
Casi frequenti
Il lock è scaduto durante la revisione Se impieghi più di 30 minuti, vedrai un messaggio "lock scaduto" al salvataggio. Ricarica la pagina, ri-prendi in carico il documento e prosegui la revisione.
Un collega ha preso in carico un documento urgente Contatta il collega o l'amministratore tenant. L'amministratore può sbloccare il documento.