Cos'è il planning tool di un agente?

Un agent planning tool è un tool esplicito che un agente basato su modello linguistico chiama per scrivere, leggere e aggiornare una todo-list strutturata e persistente mentre esegue un task lungo, con voci che passano tipicamente per gli stati pending, in_progress e completed. Non è il ragionamento interno che porta l'agente a decidere quali passi servono, quello è la task decomposition, ma il meccanismo con cui quel piano viene reso una struttura dati concreta, esterna al flusso di pensiero del modello e consultabile passo dopo passo. Due implementazioni note lo mostrano bene: LangChain espone il tool write_todos tramite il middleware TodoListMiddleware nel progetto deepagents, mentre Claude Code è passato dal singolo tool TodoWrite a una Tasks API composta da TaskCreate, TaskUpdate, TaskList e TaskGet. In entrambi i casi l'oggetto di questa voce è il tool in sé, non il componente più ampio dell'infrastruttura attorno al modello descritto nell'agent harness.

Leggi anche: Task decomposition · Il processo con cui un agente scompone un obiettivo complesso in sotto-obiettivi più piccoli prima di agire.

Perché renderlo un tool esplicito, non solo ragionamento

Se il piano resta solo nel testo generato dal modello, nessuno all'esterno può ispezionarlo in modo affidabile: bisognerebbe rileggere l'intera catena di ragionamento per capire cosa l'agente ha deciso di fare e a che punto è arrivato. Un tool dedicato risolve tre problemi concreti. Primo, rende il piano ispezionabile in ogni momento da chi osserva l'esecuzione, non solo alla fine. Secondo, permette a un umano di intervenire a metà lavoro: vedere che un passaggio è sbagliato o superfluo e correggere la todo-list prima che l'agente prosegua su una base errata. Terzo, la todo-list sopravvive alle compattazioni del contesto: quando la conversazione viene riassunta per liberare spazio, un piano scritto solo a parole rischia di perdersi nel taglio, mentre uno stato strutturato persiste come dato, indipendente dalla finestra di contesto corrente.

Un esempio pratico

Un agente incaricato di una migrazione dati multi-step, ad esempio spostare uno schema legacy verso una nuova piattaforma cloud passando per estrazione, validazione, trasformazione e caricamento, scrive all'inizio una todo-list con queste quattro voci in stato pending. Man mano che procede aggiorna ogni voce a in_progress e poi a completed, e può aggiungerne di nuove se scopre un passaggio non previsto, come una tabella con vincoli di integrità da gestire a parte. Chi supervisiona il lavoro vede lo stato di avanzamento reale interrogando la todo-list, invece di dover dedurlo scorrendo centinaia di righe di log grezzi.

Perché conta per chi decide

Un sistema agentico che espone un planning tool esplicito offre una superficie di controllo che un sistema senza quel tool non ha: si può fermare l'esecuzione a metà, verificare che il piano abbia senso per il processo aziendale in questione, e correggerlo senza dover riavviare il task da zero. Chi valuta un fornitore o una piattaforma agentica dovrebbe chiedere esplicitamente se il piano è una struttura dati verificabile o solo prosa generata al volo: la differenza si vede quando qualcosa va storto a metà di un'esecuzione lunga, non quando tutto funziona al primo tentativo.