Come costruire il tuo primo agente AI: guida pratica passo-passo

Di cosa parla questa guida

Un agente AI non è un chatbot più bravo. Un chatbot risponde: tu chiedi, lui produce testo, la conversazione finisce lì. Un agente riceve un obiettivo, decide da solo i passi per raggiungerlo e usa strumenti per portarlo a termine. Uno parla del lavoro, l’altro lo fa.

La guida spiega come funziona un agente sotto il cofano e come costruirne uno utile senza saper programmare: le quattro capacità che lo rendono tale, i pezzi di cui è fatto, il ciclo che ripete a ogni passo, gli strumenti disponibili oggi e tre esempi costruiti passo passo.

Metà del testo riguarda cosa un agente può fare, l’altra metà come tenerlo sotto controllo: un sistema che agisce può sbagliare in modo più costoso di uno che parla. Livelli di autonomia, minimo privilegio, test, GDPR, Regolamento UE 2024/1689 e Legge 132/2025 fanno parte del progetto, non di un adempimento successivo.

Tre idee dalla guida

L’anello che separa un agente da uno script

Il cuore di ogni agente è un ciclo che si ripete: osserva la situazione, pianifica la mossa, agisce chiamando uno strumento, verifica il risultato. Poi ricomincia, finché l’obiettivo è raggiunto o finché capisce di doversi fermare. La verifica è il passo che quasi tutti dimenticano ed è quello decisivo: senza, un errore al secondo passo si trascina fino alla consegna. Uno script esegue i passi che avevi previsto e si rompe al primo imprevisto; l’anello decide ogni passo guardando la situazione reale, distingue un errore da ritentare da un risultato vuoto ma valido, e cambia strada prima di consegnare.

Quanto costa un suo errore: i tre livelli di autonomia

Autonomo non è un interruttore, è un cursore che decidi tu. Al livello assistito l’agente prepara tutto ma non preme il pulsante finale: obbligatorio per azioni irreversibili come i pagamenti. Al livello semi-autonomo lavora da solo nei tratti sicuri e si ferma sui casi ambigui, e copre la maggior parte del lavoro reale. Al livello autonomo agisce entro un recinto stretto, su compiti ripetitivi e facili da annullare, con un registro di ciò che ha fatto. La domanda giusta non è quanto può essere autonomo, ma quanto costa un suo errore qui. Si parte sempre dal livello più cauto.

Le cinque domande prima di scrivere una riga

Si parte dal compito, non dallo strumento. Qual è il risultato esatto che voglio, detto con precisione e non come area generica? Come faccio oggi questo lavoro, passo per passo: se non sai descriverlo a mano, non puoi delegarlo. Quali informazioni e quali strumenti servono davvero, sapendo che rispondere "a tutto" significa non aver capito il compito? Cosa succede se sbaglia, perché il danno peggiore decide il livello di autonomia e i controlli? Come riconosco un buon risultato, senza il quale non potrai né testare né migliorare l’agente? Cinque risposte trasformano un’idea vaga in un progetto.