> For the complete documentation index, see [llms.txt](https://transizionedigitale.gitbook.io/ai-pa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://transizionedigitale.gitbook.io/ai-pa/rag-documenti/gestione-documentale-per-lanalisi-ai.md).

# Gestione documentale per l'analisi AI

come organizzare la documentazione prima di caricarla nell'AI

{% hint style="info" %}
Capitolo introdotto il 29.10.2026 grazie al [**Notebook**](https://notebook.google.com/notebook/bdb491e1-2582-4a94-9ad9-288afcf886da) **Gemini** denominato "I**ntelligenza artificiale e analisi documentale nella pubblica amministrazione**" creato da **Vincenzo Laudani** nel contesto del post "**L'errore più pericoloso dell'IA? Quello che non compare nella risposta**", pubblicato nella community sull'uso dell'AI nella PA [GenerativePA](https://generativepa.circle.so/c/video-tutorial/l-errore-piu-pericoloso-dell-ia-quello-che-non-compare-nella-risposta). \
Sul Notebook è stato chiesto con prompt di generare un manuale operativo pratico per la gestione documentale ottimale per le analisi degli agenti di AI, avendo come fonte il video creato da **Vincenzo Laudani**
{% endhint %}

<div align="left"><figure><img src="https://1920127677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeGHS705RnwfBUyjXEMx%2Fuploads%2FRlpbf2VzeqxHbrd7qqYx%2Fimage.png?alt=media&amp;token=e0e8a84e-1be6-44b8-99a1-0fd0eb6b91f2" alt="" width="339"><figcaption></figcaption></figure></div>

### Premessa e principi guida

L'attività della Pubblica Amministrazione si fonda sulla **gestione degli atti dell'istruttoria**. In sede di riesame interno o di contenzioso davanti al giudice amministrativo, la tenuta del provvedimento dipende direttamente dalla completezza e dalla correttezza della ricostruzione documentale. Un'incompleta o errata lettura degli atti (come la mancata valutazione delle note di un privato o degli allegati tecnici) può determinare un **vizio d'istruttoria**, esponendo l'amministrazione a contestazioni, all'annullamento dell'atto e al rischio di danno erariale.

L'adozione dell'intelligenza artificiale accelera drasticamente l'esame di fascicoli complessi, multilaterali o stratificati negli anni. Tuttavia, la velocità operativa risulta dannosa se comporta la perdita di passaggi decisivi della vicenda. I moderni modelli di IA raramente commettono allucinazioni pure; il rischio principale risiede negli **errori di lettura della fonte** o nella **mancata considerazione di atti rilevanti**.

Per garantire risultati non solo rapidi, ma giuridicamente **affidabili, trasparenti e controllabili**, occorre strutturare una rigorosa catena di gestione documentale.

### Fase 1: Selezione e pulizia dell'input documentale

Il processo di analisi non parte dal prompt, ma dalla **selezione preventiva del materiale documentale** da somministrare al sistema.

* **Eliminazione delle ridondanze e delle bozze**: È necessario inserire nel fascicolo di analisi esclusivamente gli atti definitivi e vigenti (es. l'ultima versione approvata del capitolato o del contratto, escludendo le bozze intermedie o i testi superati). Un volume eccessivo o ridondante di documenti confonde l'algoritmo e aumenta la percentuale di errore o omissione.
* **Garantire la completezza essenziale**: La rimozione dei file superflui non deve mai tradursi nell'omissione di allegati tecnici, verbali, perizie o note di contestazione dell'impresa. La mancanza di un allegato del capitolato può inficiare l'intera ricostruzione degli obblighi contrattuali.
* **Controllo preventivo della leggibilità (OCR)**: È fondamentale verificare lo stato dei file scansionati o digitalizzati da fonte analogica. I documenti con testo poco chiaro o scansionato richiedono una maggiore attenzione, poiché l'OCR dell'IA potrebbe non estrarne correttamente il contenuto.

### Fase 2: Nomenclatura strutturata e organizzazione in sotto-insiemi

Per consentire all'IA di orientarsi con precisione nei fascicoli ad alta densità documentale, è indispensabile curare la struttura e la denominazione dei file.

* **Denominazione uniforme e cronologica**: Tutti i file devono recare un nome chiaro e identificativo, utilizzando codici cronologici o numeri di protocollo (es. 01\_Contratto\_firmato.pdf, 02\_Verbale\_SAL1\_2025.pdf, 03\_Contestazione\_Impresa\_Prot123.pdf). Tale pratica facilita sia l'indicizzazione dell'algoritmo sia la rintracciabilità da parte dell'operatore umano.
* **Suddivisione in sotto-cartelle o archivi tematici**: Quando il fascicolo è molto esteso, è opportuno dividere i documenti in sotto-cartelle o archivi zip distinti per tipologia (es. *Contratto\_e\_Capitolato*, *Comunicazioni\_Impresa*, *Verbali\_DL*, *Contabilità\_SAL*). In questo modo si guida la ricerca dell'IA verso contenitori specifici a seconda del quesito posto.

### Fase 3: Definizione dello scopo e delimitazione del perimetro

L'interrogazione del sistema deve avvenire all'interno di un perimetro operativo ben definito.

* **Esplicitazione dello scopo operativo**: Prima di richiedere qualsivoglia sintesi, occorre chiarire la finalità specifica dell'analisi (es. ricostruzione della cronologia dei ritardi, verifica dell'iter delle varianti, individuazione delle contestazioni risarcitorie). In assenza di uno scopo esplicito, l'IA produce sintesi generiche, disperdendo i dettagli vincolanti.
* **Delimitazione delle fonti autorizzate**: Bisogna indicare tassativamente nell'istruzione se il sistema debba **limitarsi esclusivamente ai file presenti nel fascicolo** caricato oppure se sia autorizzato a consultare **fonti o banche dati esterne** (es. per verificare la reperibilità di un componente tecnico sul mercato).

### Fase 4: Catena di processo ed esecuzione dell'analisi

Nei fascicoli complessi, l'analisi deve procedere per stadi sequenziali ed evitare la richiesta immediata di report finali omnicomprensivi.

* **Ricognizione parziale per atti o sotto-gruppi**: Iniziare richiedendo una ricognizione analitica dei singoli file o delle specifiche cartelle tematiche per estrarre le informazioni pertinenti allo scopo.
* **Adozione del formato tabellare**: È consigliabile richiedere l'output della ricognizione sotto forma di **tabella**, poiché i modelli di IA strutturano ed elaborano i dati tabellari con maggiore accuratezza e minor margine di equivoco rispetto al testo libero.
* **Sintesi complessiva guidata**: Solo dopo aver eseguito e controllato la ricognizione parziale, si procede a richiedere una relazione sintetica complessiva, richiamando sempre lo scopo dell'istruttoria.

### Fase 5: Ancoraggio documentale, tripartizione dell'output e riesame

Per garantire la verificabilità delle conclusioni, l'output generato dall'IA deve rispettare precisi standard di trasparenza.

* **Imposizione dell'ancoraggio documentale**: Ogni affermazione contenuta nel report dell'IA deve essere accompagnata dal **citato testuale esatto** e dal **riferimento al file di origine** (o link alla libreria documentale). L'operatore umano deve verificare se la citazione sia letterale o se costituisca una mera parafrasi.
* **Distinzione vincolante su tre livelli informativi**:
  1. **Fatti accertati dagli atti**: Dati certi e clausole di contratto/capitolato sottoscritte.
  2. **Dichiarazioni e interpretazioni delle parti**: Tesi, riserve o contestazioni soggettive sostenute dal privato o dall'amministrazione.
  3. **Incertezze e lacune documentali**: Il sistema deve essere espressamente autorizzato a segnalare i punti dubbi o i documenti mancanti, anziché mostrare una falsa sicurezza.
* **Riesame mirato guidato (Human-in-the-Loop)**: Per verificare che il sistema non abbia ignorato atti decisivi, occorre richiedere un riesame mirato imponendo all'IA di confrontare il report con l'elenco iniziale delle fonti per evidenziare eventuali passaggi omessi o contraddittori. Successivamente, l'operatore umano deve eseguire un **controllo a campione** sui punti nodali.

### Cose da evitare (vademecum degli anti-pattern)

🚫 **1. Non caricare mai bozze, duplicati o versioni superate dello stesso atto** Caricare più bozze intermedie insieme al contratto finale confonde il modello, che rischia di citare clausole modificate o espunte nella versione definitiva.

🚫 **2. Non fornire mai una relazione di sintesi priva dei relativi allegati tecnici** Fornire una lettera o una sintesi escludendo gli allegati tecnici (es. grafici, schede di capitolato) impedisce all'IA di rilevare obblighi contrattuali vincolanti, compromettendo la strategia dell'amministrazione.

🚫 **3. Non utilizzare nomi file generici, alfanumerici o privi di significato** Nomi come Scan\_00012.pdf o Documento\_nuovo.pdf ostacolano la tracciabilità delle fonti e rendono disagevole il controllo incrociato da parte del funzionario.

🚫 **4. Non richiedere immediatamente una relazione conclusiva generale su fascicoli estesi** Evitare di lanciare un prompt del tipo "Sintetizza l'intero fascicolo e dimmi chi ha ragione": senza una preventiva ricognizione parziale tabellare, l'IA ometterà inevitabilmente passaggi istruttori decisivi.

🚫 **5. Non consentire all'IA di confondere le tesi di parte con le clausole contrattuali** Non accettare risposte in cui la posizione interpretativa espressa da una parte in una nota venga presentata dall'IA come norma o clausola vincolante del contratto.

🚫 **6. Non fidarsi mai di una risposta solo perché appare ben scritta o motivata** Una sintesi redatta in uno stile professionale ed elegante può comunque essere del tutto incompleta o basata sull'omissione di una nota decisiva.

🚫 **7. Non porre domande generiche di controllo come "Sei sicuro di quello che dici?"** I modelli di IA tendono a confermare le proprie risposte. Il riesame deve essere sempre **mirato**, chiedendo esplicitamente al sistema di confrontare l'output con l'elenco iniziale delle fonti per rilevare documenti non considerati.

🚫 **8. Non sostituire il controllo umano (Human-in-the-Loop)** L'IA velocizza l'esame della documentazione, ma la responsabilità del provvedimento e la verifica della tenuta giuridica rimangono in capo al funzionario amministrativo.

```mermaid
graph LR
 
    Root["🚫 Errori da evitare"]

    %% Ramo Documenti
    Root --> D["📁 Gestione Documenti"]
    D --> D1["1. Bozze e versioni superate<br/>(clausole modificate o espunte)"]
    D --> D2["2. Assenza allegati tecnici<br/>(obblighi contrattuali persi)"]
    D --> D3["3. Nomi generici Scan_xxx<br/>(tracciabilita ostacolata)"]

    %% Ramo Prompting
    Root --> P["💬 Prompting e Istruttoria"]
    P --> P1["4. Sintesi globale immediata<br/>(omissione passaggi decisivi)"]
    P --> P2["7. Domande generiche 'Sei sicuro?'<br/>(tendenza all'autoconferma)"]

    %% Ramo Validazione
    Root --> V["⚖️ Validazione e Controllo"]
    V --> V1["5. Scambiare tesi di parte per clausole"]
    V --> V2["6. Fidarsi della sola bella scrittura"]
    V --> V3["8. Esclusione del controllo umano (Human In The Loop)"]

    %% Stili sicuri per GitBook
    style Root fill:#1e293b,stroke:#0f172a,color:#ffffff
    style D fill:#f1f5f9,stroke:#94a3b8,color:#0f172a
    style P fill:#f1f5f9,stroke:#94a3b8,color:#0f172a
    style V fill:#f1f5f9,stroke:#94a3b8,color:#0f172a
```

Checklist riassuntiva pronta all'uso per i funzionari dell'ufficio prima di caricare i file nell'IA

<table><thead><tr><th width="150">Fase del Processo</th><th width="246">💡 Azioni e Controlli da Effettuare</th><th width="240">Scopo Operativo e Motivazione</th><th>Esito (✓ / ✗)</th></tr></thead><tbody><tr><td>1. Selezione e Pulizia</td><td>Rimozione di bozze e duplicati: Eliminare le bozze intermedie o i testi superati, caricando esclusivamente gli atti definitivi (es. solo l'ultimo capitolato approvato o il contratto firmato).</td><td>Un volume eccessivo o ridondante di documenti confonde l'algoritmo e aumenta il rischio di omissioni.</td><td>[ ]</td></tr><tr><td>2. Completezza Atti</td><td>Inclusione degli allegati essenziali: Verificare la presenza di tutti gli allegati tecnici, le perizie, i verbali e le note di contestazione del privato o della direzione lavori.</td><td>L'assenza anche di un solo allegato o comunicazione può nascondere obblighi contrattuali o contestazioni decisive.</td><td>[ ]</td></tr><tr><td>3. Nomenclatura</td><td>Codifica chiara dei file: Rinominare tutti i file in modo univoco, indicando il numero di protocollo o una sequenza cronologica (es. 01_Contratto.pdf, 02_Verbale_SAL1.pdf).</td><td>Facilita l'indicizzazione da parte del sistema e la rintracciabilità rapida per l'operatore umano.</td><td>[ ]</td></tr><tr><td>4. Organizzazione</td><td>Suddivisione in sotto-cartelle/ZIP: Per fascicoli complessi o estesi, raggruppare i file per tipologia tematica (es. Contratto, Verbali_DL, Comunicazioni).</td><td>Permette di orientare l'IA verso contenitori specifici a seconda della ricerca.</td><td>[ ]</td></tr><tr><td>5. Controllo Leggibilità</td><td>Verifica OCR e scansionati: Controllare lo stato di nitidezza dei file scansionati o digitalizzati da fonte analogica.</td><td>I file scansionati sono più difficili da interpretare e richiedono verifiche mirate a campione.</td><td>[ ]</td></tr><tr><td>6. Scopo e Perimetro</td><td>Definizione dell'obiettivo: Esplicitare chiaramente lo scopo dell'analisi (es. cronologia dei ritardi, ricostruzione varianti) prima di interrogare il sistema.</td><td>Impedisce all'IA di produrre sintesi generiche che disperdono i dettagli vincolanti.</td><td>[ ]</td></tr><tr><td>7. Delimitazione Fonti</td><td>Regolazione dell'accesso esterno: Specificare se l'IA deve limitarsi esclusivamente ai file caricati o se è autorizzata a consultare banche dati esterne.</td><td>Previene l'introduzione di informazioni esterne non pertinenti all'istruttoria.</td><td>[ ]</td></tr><tr><td>8. Formato Output</td><td>Estrazione tabellare parziale: Richiedere la prima ricognizione in formato tabellare per singoli atti o gruppi di file.</td><td>L'IA elabora le tabelle con maggiore precisione e con minor margine di errore rispetto al testo libero.</td><td>[ ]</td></tr><tr><td>9. Ancoraggio Testuale</td><td>Citazione esatta e riferimento: Imporre al sistema l'inserimento del citato testuale esatto e del riferimento preciso al file di provenienza.</td><td>Consente di verificare se il testo è stato realmente letto e non semplicemente parafrasato.</td><td>[ ]</td></tr><tr><td>10. Tripartizione</td><td>Separazione dei livelli informativi: Istruire l'IA a distinguere fatti accertati, dichiarazioni/interpretazioni delle parti e incertezze o lacune.</td><td>Evita che la tesi soggettiva di una parte venga scambiata per una clausola contrattuale vincolante.</td><td>[ ]</td></tr><tr><td>11. Riesame Mirato</td><td>Controllo delle omissioni: Richiedere all'IA di confrontare il report con l'elenco iniziale delle fonti per evidenziare documenti o passaggi non considerati.</td><td>Riduce il rischio di errori di lettura della fonte e previene vizi d'istruttoria.</td><td>[ ]</td></tr><tr><td>12. Verifiche Umane</td><td>Controllo Human-in-the-Loop: Effettuare controlli diretti a campione sui punti nodali del fascicolo prima dell'adozione del provvedimento.</td><td>Garantisce la tenuta giuridica dell'atto amministrativo ed evita contestazioni o danno erariale.</td><td>[ ]</td></tr></tbody></table>

#### Griglia di prompt pronti all'uso per guidare l'utente nelle diverse fasi dell'istruttoria. I prompt incorporano le regole di processo per evitare errori di lettura, omissioni di atti vincolanti o sovrapposizioni tra fatti e tesi di parte.

<table><thead><tr><th width="129">Fase della Checklist</th><th width="155">Obiettivo Operativo</th><th width="300">Prompt di Esempio (Testo pronto da copiare e adattare)</th><th>Istruzioni Chiave ed Effetto Atteso</th></tr></thead><tbody><tr><td>Fasi 6 e 7 (Scopo e Perimetro)</td><td>Fissare l'obiettivo e delimitare le fonti autorizzate</td><td>Agisci in qualità di istruttore amministrativo esperto. Devi analizzare il fascicolo documentale caricato relativo a: [INSERIRE OGGETTO, es. Appalto Lavori Scuola X].<br>SCOPO DELL'ANALISI: [Es. Ricostruire le cause e le responsabilità dei ritardi nell'esecuzione del cronoprogramma].<br>PERIMETRO E FONTI: Limita la tua analisi ESCLUSIVAMENTE ai documenti presenti nel fascicolo fornito.<br>NON utilizzare fonti o ricerche esterne. Se un'informazione non è presente negli atti caricati, segnalala espressamente come lacuna documentale senza formulare ipotesi.</td><td>Definisce il perimetro per evitare che il sistema produca sintesi generiche o introduca informazioni estranee al fascicolo.</td></tr><tr><td>Fasi 8 e 9 (Ricognizione e Ancoraggio)</td><td>Eseguire una prima ricognizione tabellare con citazione letterale</td><td>Analizza il sotto-insieme documentale [NOME_CARTELLA_O_ZIP, es. 02_Comunicazioni_Impresa] in relazione allo scopo dell'analisi. Esegui la ricognizione restituendo l'output ESCLUSIVAMENTE in formato TABELLA con le seguenti colonne:<br>1. Nome File e Protocollo / Data<br>2. Tipologia dell'Atto e Mittente/Destinatario<br>3. Fatti rilevanti ai fini dello scopo<br>4. Estratto Testuale Esatto (citazione letterale tra virgolette dall'atto)<br>5. Riferimento/Link al file di origine ISTRUZIONE VINCOLANTE: Riporta la citazione testuale esatta, senza fare riassunti o parafrasi nell'estratto.</td><td>Impone la struttura tabellare e l'ancoraggio testuale diretto. La presenza di un riassunto anziché del testo esatto segnala una possibile errata lettura dell'atto.</td></tr><tr><td>Fase 10 (Tripartizione dell'Output)</td><td>Distinguere fatti accertati, tesi di parte e incertezze</td><td>Sulla base della ricognizione svolta, elabora la relazione di sintesi per il fascicolo [NOME_FASCICOLO]. Devi articolare la relazione applicando TASSATIVAMENTE la seguente tripartizione:<br>1. FATTI ACCERTATI DAGLI ATTI: Inserisci solo elementi certi, date e clausole del contratto/capitolato regolarmente sottoscritte.<br>2. DICHIARAZIONI E INTERPRETAZIONI DI PARTE: Distingui nettamente le riserve, le contestazioni o le tesi sostenute dall'impresa o dall'amministrazione, senza scambiarle per clausole contrattuali.<br>3. INCERTEZZE E LACUNE DOCUMENTALI: Segnala esplicitamente i punti di dubbio, i contrasti interpretativi o gli eventuali documenti mancanti necessari per decidere.</td><td>Impedisce all'IA di confondere una posizione soggettiva di parte con una norma o clausola vincolante del contratto.</td></tr><tr><td>Fase 11 (Riesame Mirato)</td><td>Identificare documenti omessi o contraddizioni</td><td>Esegui un riesame mirato del report di sintesi appena generato. Confronta la relazione conclusiva con l'elenco iniziale di tutti i file presenti nel fascicolo caricato e segnala:<br>1. Qualsiasi documento, nota o allegato tecnico fornito che NON sia stato considerato o citato nelle conclusioni.<br>2. Eventuali comunicazioni o riserve dell'impresa che contraddicono o attenuano le conclusioni raggiunte.<br>3. Punti in cui è stata effettuata una parafrasi invece di una lettura diretta della fonte.</td><td>Evita domande generiche del tipo "sei sicuro?" e costringe il sistema a un controllo incrociato mirato tra fonti e conclusioni.</td></tr></tbody></table>

| Mappatura operativa dei prompt nella catena di processo                     |
| --------------------------------------------------------------------------- |
| \[ Input: File Definitivi e Puliti ] (Fasi 1-5 Checklist)                   |
| ▼                                                                           |
| \[ PROMPT 1: Setup Scopo & Perimetro ] (Fasi 6-7 Checklist)                 |
| ▼                                                                           |
| \[ PROMPT 2: Ricognizione Tabellare & Ancoraggio ] (Fasi 8-9 Checklist)     |
| ▼                                                                           |
| \[ PROMPT 3: Sintesi Tripartita Fatti/Tesi/Incertezze ] (Fase 10 Checklist) |
| ▼                                                                           |
| \[ PROMPT 4: Riesame Mirato sulle Omissioni ] (Fase 11 Checklist)           |
| ▼                                                                           |
| \[ Controllo Umano (Human-in-the-Loop) finale ] (Fase 12 Checklist)         |