Controllo AI manuale tecnico-files¶
Obiettivo¶
Il controllo AI su /tecnico-files/ serve a proporre metadati per i file caricati:
- cliente probabile;
- tipo/categoria documento;
- date di stesura, decorrenza, scadenza;
- soggetti rilevanti;
- campi dinamici definiti per profilo documento.
L'AI non deve modificare documenti, clienti, categorie o scadenze in autonomia.
Utenti istruttori¶
La fase iniziale abilita come istruttori:
- Emma;
- Roem;
- admin tecnici/tenant.
Gli istruttori possono:
- creare profili di controllo per categoria documento;
- impostare focus di ricerca;
- definire campi dinamici in JSON;
- correggere e confermare le proposte AI.
La categoria del profilo deve essere scelta dal tree categorie documentale. Non e' un campo libero.
Se l'AI non trova una categoria adatta, puo' solo proporre una nuova categoria come ai_suggested=true
dentro la proposta documento; Emma, Roem o un admin decidono poi se creare una categoria reale.
Prima di proporre una categoria nuova deve confrontare l'albero categorie disponibile. Se resta incerta,
deve produrre domande di chiarimento invece di inventare.
Solo il JSON confermato da un istruttore e' considerato fonte affidabile per tutor e futuri precompilatori.
Gli utenti operativi possono confermare solo quando l'analisi e' agganciata a un profilo gia' approvato. Se la categoria esiste ma manca il profilo, il sistema crea una bozza profilo proposta dall'AI e richiede un istruttore.
Nei documenti cliente gia' caricati e senza categoria, il pannello tecnico puo' mostrare il bottone
Classifica AI. L'applicazione della categoria segue gli stessi vincoli: profilo approvato per utente
operativo, istruttore per profili mancanti o categorie nuove.
Guardrail¶
- Se un dato non e' scritto chiaramente nel documento, il campo deve restare vuoto.
- I dati incerti devono essere segnalati in
warning. - La confidenza deve accompagnare i suggerimenti principali.
- Il collegamento a cliente/categoria resta manuale nella prima fase.
- I file originali non vengono duplicati sulla macchina AI.
Tabelle¶
tecnico_file_ai_profile: profili documento configurati dagli istruttori.tecnico_file_ai_analysis: proposte AI, conferme umane, modello usato, hash testo e snapshot profilo.
Primo perimetro formati¶
- TXT/CSV/MD;
- DOCX;
- XLSX;
- PDF testuali quando la libreria PDF e' disponibile.
PDF scansionati e immagini richiederanno uno step successivo OCR/vision.