Il tuo primo flusso multi-agente: la guida pratica
Sesto e ultimo articolo della serie sui sistemi multi-agente. Un metodo in sei passi per costruire il tuo primo flusso, con un esempio dall'inizio alla fine.
Serie · Sistemi multi-agente
- 1. Il team leader invisibile
- 2. Anatomia dell’orchestrazione
- 3. I sub-agenti di Claude Code
- 4. I Workflow
- 5. Pattern avanzati e l’arte di sapersi fermare
- 6. Il tuo primo flusso: guida pratica — stai leggendo
Sesto e ultimo articolo della serie. Cinque puntate di concetti; adesso un metodo concreto da usare la prossima volta che hai davanti un lavoro grosso.
Abbiamo visto il concetto, l’anatomia, i sub-agenti, i Workflow e i pattern. Ora mettiamo tutto a terra in una procedura che puoi seguire passo dopo passo. Non serve saper programmare per capirla: è, prima di tutto, un modo di ragionare sul lavoro.
Passo zero: ne vale la pena?
Prima di costruire qualsiasi cosa, la domanda della guida “Conviene o no?” dell’articolo precedente. Il tuo compito rientra in almeno uno di questi casi — proteggere il contesto, parallelizzare, specializzare? Se no, fermati qui: un solo agente fatto bene ti basta. Se sì, prosegui.
I sei passi
1. Scomponi per contesto, non per problema. Dividi il lavoro in pezzi che non hanno bisogno di sapere le stesse cose. Se due parti condividono molto contesto, tienile insieme: separarle crea solo il “telefono senza fili”.
2. Scrivi il brief di ogni pezzo. Per ciascun sub-agente, i quattro punti di sempre: obiettivo, formato del risultato, strumenti e fonti, confini. È qui che si decide la qualità, molto più che nella scelta del modello.
3. Scegli lo schema. Se i pezzi sono indipendenti, fan-out: tutti insieme. Se c’è una catena di lavorazione, pipeline: ogni elemento scorre da solo senza aspettare gli altri. La barriera solo quando devi davvero unire tutto prima di procedere.
4. Metti un controllo. Non fidarti del primo risultato. Fai verificare le affermazioni chiave da un agente indipendente, con istruzioni severe: controlla tutti i casi, non dichiarare valido senza aver verificato davvero.
5. Sintetizza. Un ultimo passaggio raccoglie solo ciò che ha superato il controllo e compone il risultato finale, ordinato e con le fonti.
6. Migliora il prompt prima dell’architettura. Se qualcosa non funziona, la prima cosa da sistemare sono le istruzioni, non la struttura. Si aggiunge complessità solo quando i fatti la richiedono.
Un esempio dall’inizio alla fine
Mettiamo che io voglia un quadro affidabile su un tema, partendo da molte fonti diverse — il classico lavoro di ricerca e sintesi.
- Ne vale la pena? Sì: è parallelizzabile (fonti indipendenti) e protegge il contesto (tante letture che non voglio in testa tutte insieme).
- Scomposizione: quattro sub-agenti, ognuno su un gruppo di fonti o un sotto-aspetto del tema.
- Brief: a ciascuno dico cosa cercare, in che formato tornare (una lista di punti con fonte), dove guardare e dove fermarsi.
- Schema: fan-out, perché i quattro non dipendono l’uno dall’altro.
- Controllo: uno scettico ricontrolla le affermazioni importanti confrontandole con le fonti citate.
- Sintesi: un agente finale compone il rapporto, tenendo solo ciò che ha retto alla verifica e agganciando le citazioni.
Il risultato è un quadro più completo e più affidabile di quello che otterrei leggendo tutto da solo, e in una frazione del tempo.
Come si traduce in Claude Code
In pratica hai due strade. Puoi lavorare a mano: crei o richiami i sub-agenti uno alla volta e ricomponi tu. Oppure, se il lavoro si ripete, scrivi un Workflow che esegue l’intero flusso da solo. Il consiglio è lo stesso del passo 6: parti dal semplice. Prova prima con un paio di deleghe manuali; automatizza solo quando vedi che il metodo funziona e ti serve ripeterlo.
La chiusura della serie
Se c’è una cosa da portare via da questi sei articoli, è che il valore di questi strumenti non sta nella tecnologia, ma nel metodo che ci obbligano a mettere a fuoco. Scomporre bene un problema, scrivere una delega chiara, controllare i risultati, ricomporre con lucidità: sono competenze da coordinatore, valide con o senza intelligenza artificiale. Gli agenti le amplificano; non le sostituiscono.
Il team leader invisibile con cui abbiamo aperto la serie, alla fine, sei tu.
In sintesi — la checklist
1) Ne vale la pena? (contesto, parallelismo, specializzazione) · 2) Scomponi per contesto · 3) Brief in quattro punti · 4) Fan-out o pipeline · 5) Verifica indipendente · 6) Sintesi · 7) Migliora il prompt, non l’architettura. Parti sempre dal più semplice che funziona.
← Precedente: Pattern avanzati e l’arte di sapersi fermare
Blogger dal 2001, Nativo Digitale, Developer.
Da 15 anni mi occupo di IT per una grande Azienda.
Lavoro per abbattere il Digital Divide.
Visita i miei altri progetti
sardiniamobility.com
www.cyberness.it