Classificazione documenti

Caricamento e categorizzazione automatica dei documenti — formati, regole, soglia di confidenza, coda di revisione umana, esiti e metriche di accuratezza.

La Classificazione documenti riconosce automaticamente la tipologia di un documento, ne estrae i dati rilevanti e lo instrada verso la destinazione corretta: pratica, cartella clinica, protocollo, gestionale.

ConsoleClassificazione documenti

Prima di iniziare

Permesso console:documents:read per consultare i documenti
Permesso console:documents:write per caricare e riclassificare
Permesso console:documents:review per approvare o rifiutare in coda di revisione
Almeno una categoria configurata con relative regole

Caricare i documenti

ConsoleClassificazione documentiCarica

Scegli la sorgente

Caricamento manuale (trascina i file nell'area di rilascio), cartella monitorata (SFTP o Azure Blob Storage), email dedicata (inoltro degli allegati a un indirizzo del tenant), oppure API per l'invio dai tuoi sistemi.

Attendi l'elaborazione

Ogni documento passa per estrazione testo, OCR se necessario, classificazione ed estrazione campi. Lo stato è visibile in tempo reale nell'elenco.

Verifica l'esito

I documenti sopra la soglia di confidenza sono classificati automaticamente. Gli altri entrano nella coda di revisione umana.

POST/console/v1/documentsAPI Key

Carica un documento per la classificazione. Corpo multipart/form-data con il file e, in opzione, projectId e metadata.

Formati supportati

Formato	Estensioni	Trattamento
PDF testuale	`.pdf`	Estrazione diretta del testo, massima accuratezza
PDF scansionato	`.pdf`	OCR automatico pagina per pagina
Documenti Word	`.docx`, `.doc`	Estrazione testo e tabelle
Fogli di calcolo	`.xlsx`, `.xls`, `.csv`	Estrazione per foglio e per intestazione
Immagini	`.png`, `.jpg`, `.jpeg`, `.tiff`	OCR, italiano e inglese, altre lingue su richiesta
Email	`.eml`, `.msg`	Corpo e allegati elaborati separatamente
Archivi	`.zip`	Estrazione ricorsiva fino a 200 file

Limiti: 50 MB per file, 300 pagine per documento, 500 file per caricamento massivo.

Qualità della scansione

Per l'OCR usa scansioni a 300 DPI, in bianco e nero o scala di grigi, senza inclinazione. Sotto i 200 DPI l'accuratezza cala sensibilmente, soprattutto su moduli con testo piccolo.

Categorie e sottocategorie

ConsoleConfigurazioneClassificazioneCategorie

La tassonomia è gerarchica su due livelli. Esempio per uno studio medico:

Categoria	Sottocategorie
Referti	Analisi di laboratorio, Radiologia, Cardiologia, Visite specialistiche
Amministrativi	Fatture, Note di credito, Ricevute, Preventivi
Consensi	Consenso informato, Privacy, Trattamento dati particolari
Documenti identità	Carta d'identità, Tessera sanitaria, Passaporto
Corrispondenza	PEC, Raccomandate, Comunicazioni interne

Per ogni categoria definisci: nome, descrizione (usata dal modello per il riconoscimento), campi da estrarre, destinazione e periodo di conservazione.

Regole di classificazione

ConsoleConfigurazioneClassificazioneRegole

Le regole si applicano prima del modello AI e hanno precedenza sul suo esito.

Tipo di regola	Condizione	Esempio
Nome file	Espressione regolare sul nome	`^FT-[0-9]{4}` assegna a Fatture
Testo contenuto	Presenza di una frase	"Consenso informato al trattamento" assegna a Consensi
Mittente	Indirizzo email di origine	`laboratorio@ospedale.it` assegna a Referti
Sorgente	Cartella monitorata di provenienza	`/sftp/protocollo` assegna a Corrispondenza
Metadato API	Valore passato nella richiesta	`tipo=fattura` assegna a Amministrativi

Le regole sono valutate in ordine di priorità: la prima che corrisponde vince.

Soglia di confidenza

ConsoleConfigurazioneClassificazioneSoglia di confidenza

Valore	Effetto
0,90 – 1,00	Molto conservativo: quasi tutto passa in revisione umana
0,75 – 0,89	Equilibrato, valore consigliato per l'avvio
0,60 – 0,74	Automazione elevata, controllo a campione consigliato
Sotto 0,60	Sconsigliato: aumenta gli errori di instradamento

Puoi impostare una soglia specifica per categoria: più alta sulle categorie a impatto legale (consensi, documenti identità), più bassa su quelle a basso rischio.

Partire in modalità osservazione

Nelle prime due settimane attiva Solo suggerimento: il sistema propone la categoria ma non instrada nulla automaticamente. Confronta i suggerimenti con le scelte umane, poi abilita l'automazione con una soglia informata dai dati.

Coda di revisione umana

ConsoleClassificazione documentiDa revisionare

Apri il documento

L'anteprima mostra il file a sinistra e la proposta di classificazione a destra, con punteggio di confidenza e i passaggi di testo che l'hanno determinata.

Verifica i campi estratti

Controlla i valori estratti (data, numero documento, importo, codice fiscale, nominativo). I campi con bassa confidenza sono evidenziati in arancione.

Approva o correggi

Approva conferma categoria e campi. Correggi consente di cambiare categoria, sottocategoria e valori prima dell'approvazione.

Rifiuta se necessario

Rifiuta con motivazione (documento illeggibile, fuori ambito, duplicato, dati incompleti). Il documento viene messo in quarantena e non instradato.

Le correzioni migliorano il sistema

Ogni correzione alimenta il set di esempi della categoria. Dopo circa 50 correzioni su una categoria, l'accuratezza misurata aumenta in modo significativo.

Esiti e destinazioni

Esito	Descrizione	Destinazione tipica
Classificato	Confidenza sopra soglia, instradato automaticamente	Cartella, gestionale, webhook
In revisione	Confidenza sotto soglia	Coda operatori
Approvato	Revisionato e confermato da un operatore	Destinazione della categoria
Rifiutato	Scartato con motivazione	Quarantena
Errore	File corrotto, protetto da password o formato non supportato	Coda errori

Le destinazioni si configurano per categoria: cartella su Azure Blob Storage, chiamata a un webhook, inserimento nella knowledge base o associazione a una scheda in Clienti.

Riclassificazione

ConsoleClassificazione documentiSeleziona documentiRiclassifica

Usa la riclassificazione dopo aver modificato categorie, regole o soglie. Puoi agire su una selezione manuale oppure su tutti i documenti che corrispondono ai filtri attivi.

Effetti sulle destinazioni

La riclassificazione può spostare i documenti verso una nuova destinazione e attivare di nuovo i webhook collegati. Verifica che i sistemi a valle gestiscano gli eventi duplicati in modo idempotente.

Esportazione dei risultati

ConsoleClassificazione documentiEsporta

classificazione-export.csv

documento_id,nome_file,categoria,sottocategoria,confidenza,esito,revisore,data_elaborazione,destinazione
doc_8f21c4,referto-2026-09-01.pdf,Referti,Analisi di laboratorio,0.94,Classificato,,2026-09-01T08:41:12Z,blob://referti/2026/09

Colonne dell'esportazione

documento_id,nome_file,categoria,sottocategoria,confidenza,esito,revisore,data_elaborazione,destinazione

Le stesse colonne sono disponibili via API nell'endpoint di esportazione.

Metriche di accuratezza

ConsoleClassificazione documentiMetriche

Metrica	Formula	Lettura
Accuratezza complessiva	`classificazioni_corrette / classificazioni_totali * 100`	Corrette = approvate senza modifica di categoria
Precisione per categoria	`veri_positivi / (veri_positivi + falsi_positivi) * 100`	Quanto è affidabile un'assegnazione a quella categoria
Copertura (recall)	`veri_positivi / (veri_positivi + falsi_negativi) * 100`	Quanti documenti della categoria vengono riconosciuti
Tasso di automazione	`documenti_classificati_automaticamente / documenti_totali * 100`	Effetto reale sul carico di lavoro
Tasso di correzione	`documenti_corretti / documenti_revisionati * 100`	Se cresce, la tassonomia va rivista
Tempo medio di elaborazione	`somma(t_fine - t_inizio) / documenti_elaborati`	Include OCR ed estrazione

Obiettivo realistico

Su una tassonomia ben definita, dopo il periodo di apprendimento, un'accuratezza tra il 92% e il 97% con un tasso di automazione tra il 70% e l'85% è un risultato solido. Valori superiori richiedono di norma categorie molto distinte tra loro.