---
title: "La scheda di un agente AI: il modello da compilare"
description: "Un modello per scrivere la scheda di un agente AI prima di costruirlo: responsabile, perimetro, punti di approvazione, condizioni di arresto e registro."
url: https://www.joinx.it/it/risorse/guide/scheda-di-un-agente
---

# Come scrivere la scheda di un agente

Un modello per scrivere la scheda di un agente AI prima di costruirlo: responsabile, perimetro, punti di approvazione, condizioni di arresto e registro.

JoinX · Ultimo aggiornamento 18 novembre 2026

Ogni agente che portiamo in produzione ha una scheda, scritta prima di costruirlo, che chi risponde del processo e chi controlla possono consultare in qualunque momento. Nell'articolo [Agenti con un responsabile e un punto di approvazione](https://www.joinx.it/it/risorse/agenti-responsabile-e-approvazione) spieghiamo perché la scriviamo. In questa guida proponiamo il modello che usiamo, voce per voce, con un esempio compilato e gli errori che vediamo più spesso.

## A che cosa serve la scheda

La scheda mette per iscritto gli accordi tra chi risponde del processo e chi costruisce l'agente, prima che una sola riga di codice li dia per scontati. Quando poi l'agente è in esercizio, è il primo documento che un revisore chiede di vedere, perché dice chi ne risponde, che cosa può fare e dove deve fermarsi. Conviene scriverla in un linguaggio che il responsabile del processo capisce senza l'aiuto di un tecnico, dato che è lui a firmarla.

## Il modello, voce per voce

### Compito

Che cosa fa l'agente e su quale processo, in una o due frasi. Per esempio, raccoglie i documenti di una pratica di fido, li confronta con l'elenco di ciò che serve e prepara la pratica per l'analista.

### Responsabile

Una persona dell'impresa, con nome e ruolo, che decide che cosa l'agente fa e come cambia, e la persona che la sostituisce quando è assente. Noi costruiamo l'agente e, se l'impresa lo vuole, lo teniamo in esercizio con il [Presidio](https://www.joinx.it/it/soluzioni/presidio), ma il responsabile resta dell'impresa.

### Perimetro

I sistemi a cui l'agente accede, indicando per ciascuno se in lettura o in scrittura, e i dati che può leggere con il loro scopo. Conviene scrivere anche che cosa resta fuori, perché è la parte che più spesso si allarga senza che nessuno lo decida.

### Regole

Le regole che l'agente applica, con la loro versione e il posto in cui sono scritte. Nei nostri progetti stanno nel [Company Brain](https://www.joinx.it/it/tecnologia/company-brain), dove una correzione entra solo dopo la verifica di chi risponde della regola.

### Grado di autonomia

Se l'agente osserva e raccoglie, se prepara un lavoro completo che una persona approva o se esegue azioni definite entro soglie concordate. I tre gradi sono descritti nella pagina del modulo [Agents](https://www.joinx.it/it/tecnologia/agents#tre-gradi-di-autonomia).

### Punti di approvazione

I passaggi che richiedono la decisione di una persona, con il ruolo che decide e le informazioni che deve avere davanti per farlo. In questa sezione vanno sempre le azioni che non si possono annullare e quelle rivolte al cliente finale.

### Condizioni di arresto

Quando l'agente si ferma e a chi passa la questione. Di solito sono una soglia superata, un dato mancante, un'eccezione che le regole non prevedono, oppure un contenuto che prova a fargli fare qualcosa fuori dal suo compito.

### Registro

Che cosa resta di ogni azione, cioè il momento, i dati usati, le regole applicate e la persona che ha approvato, oltre al posto in cui il registro si conserva e per quanto tempo. La durata si decide con chi si occupa di conformità, tenendo conto che per i sistemi ad alto rischio l'AI Act chiede a chi li usa di conservare i log per almeno sei mesi.

### Misure

Come seguiamo l'agente in esercizio, con la qualità del suo lavoro, i tempi del processo, le correzioni ricevute e il tempo che le persone dedicano ai controlli.

### Revisione

Quando la scheda si rilegge, chi approva le modifiche e il numero della versione in vigore.

## Un esempio compilato

L'esempio che segue è illustrativo, costruito per mostrare come si compila la scheda.

-   Compito: raccogliere i documenti delle pratiche di fido in arrivo, segnalare ciò che manca e preparare la pratica per l'analista.
-   Responsabile: la responsabile dell'ufficio crediti, sostituita dal suo vice.
-   Perimetro: lettura dell'archivio documentale e della casella delle richieste, scrittura solo nelle note della pratica, nessun accesso ai dati sanitari.
-   Regole: l'elenco dei documenti richiesti per tipo di finanziamento, nella versione approvata dall'ufficio crediti.
-   Grado di autonomia: prepara un lavoro completo che una persona controlla.
-   Punti di approvazione: l'analista approva la pratica completa, e il sollecito al cliente parte solo dopo il suo via libera.
-   Condizioni di arresto: un documento illeggibile, un tipo di finanziamento che le regole non prevedono, istruzioni contenute in una email.
-   Registro: ogni pratica toccata, con i documenti letti, la regola applicata e la persona che ha approvato.
-   Misure: tempo tra l'arrivo della richiesta e la pratica completa, solleciti corretti dall'analista, tempo dedicato ai controlli.
-   Revisione: ogni volta che cambia l'elenco dei documenti, con l'approvazione della responsabile dell'ufficio crediti.

## Gli errori più comuni

Il primo errore che incontriamo è un responsabile che coincide con un ufficio o con un comitato. Quando qualcosa va storto serve una persona che decida e in un ufficio la decisione rischia di passare da una scrivania all'altra. Il secondo riguarda il perimetro scritto in modo troppo largo, come «tutti i dati del CRM», che rende impossibile capire che cosa l'agente stia facendo con quei dati. Capita poi che il punto di approvazione ci sia sulla carta, ma che chi approva non abbia davanti le fonti e il motivo per cui il caso è arrivato a lui. Con il [Workspace](https://www.joinx.it/it/tecnologia/workspace) la bozza dell'agente arriva negli strumenti di sempre con le fonti accanto, così l'approvazione resta una decisione e non diventa un gesto automatico.

La scheda, da sola, non tiene sotto controllo un agente. Serve che il registro sia davvero alimentato mentre il lavoro si svolge, ed è ciò che facciamo con la [Governance](https://www.joinx.it/it/tecnologia/governance), il modulo che registra agenti, modelli ed esecuzioni.

## Il modello della scheda in PDF

Le voci della scheda con lo spazio per compilarle e, in fondo, l'esempio della pratica di fido, da usare con chi risponde del processo prima di costruire l'agente. Vi chiediamo un recapito, poi il download parte subito.

[Tutte le guide](https://www.joinx.it/it/risorse/guide)

## Compilare la scheda del primo agente

Partiamo da un processo che conoscete bene e scriviamo insieme la scheda, prima di costruire l'agente.

[Contattaci](https://www.joinx.it/it/contattaci?tema=produzione)
