Quando un progetto pilota di agenti non arriva in produzione, la causa raramente è il modello. È l’harness: lo strato di infrastruttura che circonda il modello e stabilisce quali strumenti può usare, con quali permessi, che cosa ricorda tra un passaggio e l’altro, che cosa succede quando qualcosa non funziona e quanto può spendere prima che qualcuno lo fermi.
Il modello è un componente che si può sostituire in un pomeriggio. L’harness è il prodotto.
Che cosa contiene un harness
Definizione degli strumenti. Ogni azione che l’agente può eseguire (consultare l’ERP, creare un ordine, inviare un’email) viene descritta con precisione: che cosa fa, quali parametri accetta, che cosa restituisce e quali effetti produce. Una descrizione ambigua dà origine a un agente che usa lo strumento sbagliato, e con sicurezza.
Permessi e ambito. Lettura e scrittura separate, credenziali limitate al minimo necessario e un elenco esplicito di ciò che l’agente non può toccare. Il principio è lo stesso che vale per qualsiasi nuovo dipendente: accesso al sistema sì, accesso a tutto il sistema no.
Memoria e contesto. Che cosa si passa al modello a ogni passaggio, che cosa si riassume, che cosa si conserva tra un’esecuzione e l’altra e che cosa si scarta. Un agente che si porta dietro tutto lo storico diventa costoso e confuso; uno che non ricorda nulla ripete il lavoro e perde il filo.
Retry e ripristino. Che cosa si fa quando uno strumento restituisce un errore, quando il modello produce qualcosa di non interpretabile o quando una chiamata esterna cade. Nuovo tentativo con attesa crescente, percorso alternativo o passaggio a una persona.
Punti di approvazione umana. Le azioni irreversibili (pagare, cancellare, comunicare con un cliente) si fermano e attendono conferma. Il resto procede. Definire bene questo confine è una decisione di business, non tecnica.
Limiti di spesa e di passaggi. Un tetto per esecuzione e uno per giorno. Senza di essi, un ciclo che nessuno aveva previsto consuma in una notte il budget di un trimestre.
Tracce. Ogni esecuzione registra che cosa ha deciso l’agente, con quali informazioni e con quale risultato. Senza tracce non è possibile alcun debug né alcuna difesa in caso di audit.
Perché è nell’harness che si vince o si perde
Un agente senza harness funziona nella demo perché la demo la conduce chi lo ha costruito. In produzione incontra dati sporchi, sistemi che rispondono in ritardo, casi che nessuno aveva previsto e utenti che chiedono cose insolite. Tutto questo lo assorbe l’harness, oppure non lo assorbe nessuno.
È anche ciò che permette di cambiare modello senza rifare il progetto. Con un’infrastruttura ben costruita, sostituire il modello sottostante richiede una riga di configurazione e una campagna di valutazione; senza, significa ripartire da zero.
Quando ha senso investire in un harness proprio, e quando no
Ha senso quando:
- L’agente eseguirà azioni reali sui sistemi aziendali, non si limiterà a redigere testi
- È previsto più di un caso d’uso: l’harness si ripaga a partire dal secondo agente
- Il processo tocca dati sensibili o decisioni con conseguenze economiche
- Si vuole conservare la libertà di cambiare fornitore del modello
Non ha senso quando:
- Il caso d’uso si risolve con un’automazione classica o un flusso di n8n
- Si tratta di una proof of concept per decidere se vale la pena proseguire: prima si valida il valore, poi si industrializza
- Non c’è nessuno che possa mantenere il sistema in seguito: un harness senza responsabile si degrada nel giro di pochi mesi
Il nostro approccio
Partiamo dall’inventario delle azioni che l’agente dovrà eseguire e dal confine di rischio: che cosa può fare da solo e che cosa richiede l’approvazione di una persona. Su questa base definiamo l’insieme degli strumenti, i permessi, i tetti di spesa e il protocollo di gestione degli errori. La valutazione si costruisce prima dell’agente, non dopo: senza un modo per misurare se funziona, non si può sapere se una modifica migliora o peggiora le cose.
In quanto laboratorio indipendente, non rivendiamo piattaforme di agenti. Se il caso si risolve con uno strumento disponibile sul mercato, lo diciamo.
Domande frequenti
Un harness è la stessa cosa di un framework per agenti? No. Un framework fornisce i componenti; l’harness è la decisione su come assemblarli per il caso specifico: quali strumenti esistono, quali permessi hanno, dove si ferma l’agente e quanto può spendere. Si può costruire su un framework oppure senza.
Si può riutilizzare tra agenti diversi? È proprio questa l’idea. Il costo elevato è quello del primo; dal secondo agente in poi si riutilizzano strumenti, permessi, tracce e limiti.
Quanto incide sul costo del progetto? Rappresenta la maggior parte del lavoro reale di un progetto di agenti. Presentarlo come un extra facoltativo è ciò che porta a progetti pilota che non escono mai dalla fase di demo.