Una Guida Pratica Ai 3 Livelli Che La Gente Continua A Confondere
La maggior parte delle persone parla degli agenti AI come se fossero un'unica cosa.
Non lo sono.
Quando un agente va oltre una semplice demo e inizia a interagire con file, API, documenti, clienti o codice di produzione, non stai più solo "dando un prompt a un modello".
Stai progettando un sistema.
E in questo sistema, tre concetti vengono continuamente confusi:
- Ingegneria delle piattaforme (harness engineering)
- Ingegneria dei cicli (loop engineering)
- Ingegneria dei grafi (graph engineering)
Ruotano tutti attorno allo stesso modello.
Influenzano tutti l'affidabilità.
E sì, possono tutti contenere cicli.
Ma risolvono problemi diversi.
Se li confondi, finisci per fare debugging nel livello sbagliato.
La Risposta in 30 Secondi
Ecco la versione chiara:
- L'ingegneria delle piattaforme costruisce l'ambiente attorno al modello
- L'ingegneria dei cicli progetta il ciclo ripetuto di lavoro e feedback
- L'ingegneria dei grafi rende esplicita la topologia del flusso di lavoro
Un buon modello mentale è:
Ambiente → Feedback → Flusso
- La piattaforma fornisce al modello strumenti, memoria, controllo e uno spazio di lavoro
- Il ciclo decide come il lavoro viene ritentato, verificato e migliorato
- Il grafo definisce quale passo può avvenire successivamente
Questa è la differenza.
Perché Questi Termini Contano Ora
Un modello grezzo non può svolgere un lavoro reale da solo.
Non può:
- mantenere lo stato del progetto tra sessioni diverse
- chiamare strumenti in modo sicuro
- ispezionare un browser
- imporre permessi
- ritentare un lavoro fallito
- validare la qualità dell'output
- instradare compiti tra specialisti
- fermarsi al momento giusto
Tutto questo deriva dal sistema che lo circonda.
Man mano che il software agentico matura, sta emergendo uno stack pratico:
- La piattaforma fornisce al modello le condizioni operative
- I cicli rendono il lavoro ripetibile e verificabile
- Il grafo rende i flussi di lavoro complessi espliciti e controllabili
Una volta che vedi questi come livelli separati, molta confusione sull'architettura AI scompare.
Cosa Include Di Solito Una Piattaforma Seria
- Iniezione di Contesto
Cosa vede il modello prima di agire:
- istruzioni
- conoscenza recuperata
- stato della conversazione
- memoria
- policy
- regole specifiche del compito
- Superfici di Azione
Cosa può fare il modello:
- chiamate API
- azioni nel browser
- comandi shell
- esecuzione di codice
- strumenti MCP
- database
- funzioni personalizzate
- Persistenza
Cosa sopravvive nel tempo:
- file
- checkpoint
- stato della sessione
- log di avanzamento
- cronologia git
- memoria a lungo termine
- Controllo dell'Esecuzione
Come viene gestita l'esecuzione:
- tentativi
- timeout
- budget
- selezione del modello
- creazione di sotto-agenti
- porte di approvazione
- Sicurezza e Governance
Cosa mantiene il sistema al sicuro:
- permessi con privilegio minimo
- isolamento
- liste bianche
- gestione dei segreti
- approvazione umana
- Osservabilità
Cosa ti permette di fare debugging:
- tracce
- input e output degli strumenti
- transizioni di stato
- latenza
- costo
- risultati delle valutazioni
Perché l'Ingegneria delle Piattaforme è Importante
Due team possono usare lo stesso modello e ottenere risultati completamente diversi.
Perché?
Perché un team fornisce al modello:
- strumenti puliti
- stato stabile
- memoria strutturata
- permessi chiari
- esecuzione osservabile
E l'altro fornisce:
- un prompt vago
- strumenti disordinati
- contesto rumoroso
- nessuna memoria
- nessuna verifica
Il modello può essere lo stesso.
Le condizioni di lavoro non lo sono.
L'ingegneria delle piattaforme è importante ogni volta che l'agente:
- non può accedere alla capacità giusta
- perde contesto tra le sessioni
- agisce in modo incoerente tra ambienti diversi
- non può essere sottoposto a audit
- ha troppi permessi
- non può riprendersi in modo pulito dopo un'interruzione
Se il modello non può operare in modo affidabile, il primo posto in cui guardare è la piattaforma.
2. Ingegneria dei Cicli (Loop Engineering)
Cosa È
Ogni agente che usa strumenti ha già un piccolo ciclo incorporato:
- chiama il modello
- osserva il risultato
- esegue gli strumenti
- reimmette le osservazioni
- ripeti fino al completamento
L'ingegneria dei cicli inizia quando progetti intenzionalmente cicli aggiuntivi attorno a quel comportamento.
Non solo "chiedi di nuovo".
Non solo "riprova".
Ma un vero sistema di lavoro e feedback.
Anatomia Di Un Buon Ciclo
Innesco
Cosa fa iniziare un nuovo ciclo?
- richiesta dell'utente
- test fallito
- nuovo documento
- esecuzione programmata
- webhook
- feedback del valutatore
Obiettivo
Quale condizione specifica stiamo cercando di raggiungere?
Non "continua a migliorare".
Un vero obiettivo.
Stato
Cosa deve sapere il ciclo successivo?
- bozza corrente
- tentativo precedente
- risultati degli strumenti
- errori
- stato di avanzamento
Politica di Azione
Cosa è permesso fare all'agente?
- modificare
- delegare
- chiamare strumenti
- spendere token
- scrivere file
- aprire PR
Prova
Come facciamo a sapere se ha funzionato?
- test
- validazione dello schema
- citazioni
- diff
- metriche
- approvazione del revisore
Feedback
Cosa è esattamente fallito?
Il feedback dovrebbe essere compatto e utilizzabile.
Regola di Arresto
Quando finisce?
- successo
- timeout
- budget esaurito
- numero massimo di tentativi raggiunto
- fallimento irreversibile
- escalation a un umano
Il Principio Più Importante Nell'Ingegneria dei Cicli
**Non creare un ciclo sulla fiducia.
Crea un ciclo sulle prove.**
"L'agente dice di aver finito" non è una condizione di arresto.
Una vera condizione di arresto assomiglia più a:
- i test passano
- lo schema viene validato
- le citazioni si risolvono
- il revisore approva
- il controllo delle policy è pulito
Questo è ingegneria dei cicli.
Perché l'Ingegneria dei Cicli Non È Solo Ingegneria dei Prompt
Un prompt dice al modello cosa fare durante una chiamata.
Un ciclo definisce cosa fa il sistema dopo la chiamata.
Questo include:
- come controlla i risultati
- come reagisce al fallimento
- come persiste i progressi
- come decide se continuare
- come termina
Fare prompt migliora una risposta.
Un ciclo migliora un processo.
Questo è un problema ingegneristico molto diverso.
3. Ingegneria dei Grafi (Graph Engineering)
Cosa È
L'ingegneria dei grafi rende esplicita la struttura del flusso di lavoro.
Risponde a una domanda diversa:
Non solo "cosa dovrebbe fare l'agente?" Ma "cosa è permesso che accada dopo?"
Nell'ingegneria dei grafi:
- i passi sono nodi
- le transizioni sono archi
- la ramificazione è esplicita
- il lavoro parallelo è esplicito
- le giunzioni sono esplicite
- i tentativi sono espliciti
- gli interventi umani sono espliciti
Il grafo diventa la mappa di controllo del sistema.
Cosa Progettano Davvero Gli Ingegneri dei Grafi
Confini dei Nodi
Cosa appartiene a:
- una funzione deterministica
- una chiamata LLM
- un agente specialista
- un passo di revisione umana
Schema di Stato
Cosa ogni nodo può leggere o scrivere.
Condizioni di Instradamento
Quale prova sposta il lavoro:
- in avanti
- indietro
- lateralmente
- verso l'escalation
Concorrenza
Cosa può essere eseguito in parallelo, e cosa deve aspettare.
Cicli e Uscite
Dove sono consentiti i tentativi, quanti sono consentiti e come si fermano.
Durabilità
Dove avvengono i checkpoint e come il flusso di lavoro riprende dopo un'interruzione.
Quando I Grafi Valgono La Pena
I grafi sono preziosi quando il processo include:
- ramificazioni significative
- approvazioni
- passaggi di consegne tra specialisti
- lavoro parallelo
- percorsi di recupero
- flussi di lavoro multi-passo con punti di controllo espliciti
Sono meno utili quando il lavoro è semplicemente:
"Dai a un agente alcuni strumenti e lascialo lavorare."
In quel caso, una solida piattaforma più alcuni cicli potrebbero essere sufficienti.
Un grafo aggiunge chiarezza, ma aggiunge anche struttura.
Troppa struttura troppo presto può rendere il sistema fragile.
Come I 3 Livelli Lavorano Insieme
Diciamo che stai costruendo un agente di ricerca e pubblicazione.
Deve:
- definire l'ambito di un argomento
- raccogliere fonti
- selezionare le citazioni
- abbozzare un rapporto
- superare una revisione legale
- pubblicare solo dopo l'approvazione
Ecco come si mappano i livelli:
Piattaforma
Fornisce:
- accesso al browser
- strumenti di ricerca
- spazio di lavoro file
- memoria
- citazioni
- approvazioni
- tracce
- instradamento del modello
Ciclo
Gestisce:
- il recupero delle fonti quando le prove sono deboli
- la correzione dei fallimenti delle citazioni
- l'esecuzione di controlli di valutazione
- l'aggiornamento del lavoro quando il mercato cambia
Grafo
Controlla il percorso:
- definizione dell'ambito
- ricerca
- selezione
- sintesi
- abbozzo
- revisione
- pubblicazione
Con un gate umano prima del rilascio.
Ecco perché i 3 livelli non sono intercambiabili.
Lavorano insieme, ma non sono la stessa cosa.
Diagnostica Il Fallimento Prima Di Scegliere La Soluzione
Ecco la regola pratica:
Se l'agente non può operare, aggiusta la piattaforma
Esempi:
- mancanza di accesso agli strumenti
- stato obsoleto
- memoria debole
- permessi errati
- nessuna osservabilità
Se l'agente funziona quasi ma è inaffidabile, aggiusta il ciclo
Esempi:
- prima bozza vicina ma debole
- successo incoerente
- tentativi non controllati
- nessuna prova di completamento
Se il processo stesso è complesso, aggiusta il grafo
Esempi:
- molti specialisti
- approvazioni
- logica di ramificazione
- percorsi paralleli
- passaggi di consegne strutturati
Errori Comuni
1. Costruire Il Grafo Troppo Presto
I team spesso diagrammano un enorme flusso di lavoro prima di vedere come si comporta effettivamente il lavoro.
Approccio migliore:
- inizia con una piattaforma più semplice
- raccogli tracce
- trova i pattern stabili
- formalizza solo ciò che merita controllo
2. Far Scrivere e Valutare lo Stesso Modello Senza Garanzie
L'autovalutazione può aiutare, ma condivide gli stessi punti ciechi.
Preferisci:
- controlli deterministici dove possibile
- contesto di revisione separato
- valutatori esterni
- approvazione umana per azioni ad alto impatto
3. Usare "Continua a Provare" Come Ciclo
Non è una progettazione di ciclo.
È una perdita di costo incontrollata.
Ogni ciclo ha bisogno di:
- un obiettivo misurabile
- prove reali
- limiti di tentativi
- regole di escalation
4. Trattare La Piattaforma Come Un Cassetto Dei Rifiuti
Più strumenti non significa automaticamente agenti migliori.
Troppi strumenti creano:
- errori di selezione
- contesto rumoroso
- scarsa affidabilità
- una superficie di rischio più ampia
Una buona piattaforma non è affollata.
È precisa.
5. Dare La Colpa Al Modello Per I Fallimenti Di Orchestrazione
Un modello non può compensare per:
- API rotte
- stato obsoleto
- condizioni di uscita mancanti
- schemi di strumenti vaghi
- modalità di fallimento invisibili
Aggiusta il livello che possiede il fallimento.
Una Semplice Checklist Per La Produzione
Piattaforma
- Gli strumenti sono ristretti e documentati?
- Lo stato è durevole?
- I permessi sono con privilegio minimo?
- Gli operatori possono mettere in pausa, ispezionare e riprendere?
- Le tracce sono visibili?
Ciclo
- Quale prova dimostra il successo?
- Quale feedback viene restituito in caso di fallimento?
- Quanti tentativi sono consentiti?
- Qual è la regola di arresto?
- Cosa succede quando il budget finisce?
Grafo
- Quali percorsi devono essere deterministici?
- Cosa può essere eseguito in parallelo?
- Dove sono i gate umani?
- Quale stato è condiviso?
- Dove iniziano i percorsi di recupero?
Valutazione
- Puoi riprodurre tracce reali?
- Puoi confrontare versioni?
- Puoi attribuire un miglioramento a un cambiamento reale?
Operazioni
- Stai tracciando il costo?
- la latenza?
- il tasso di fallimento?
- il tasso di intervento?
- il successo del compito in produzione?
Il Modo Più Semplice Per Ricordare La Differenza
Se ricordi solo una cosa, ricorda questa:
- L'ingegneria delle piattaforme rende il modello operativo
- L'ingegneria dei cicli rende il lavoro iterativo e verificabile
- L'ingegneria dei grafi rende il percorso di esecuzione esplicito e controllabile
Nessuno sostituisce gli altri.
Un grafo perfetto non salverà una piattaforma debole.
Una piattaforma forte sprecherà comunque denaro senza buoni cicli.
E cicli puliti diventano difficili da gestire quando ramificazioni e approvazioni rimangono nascoste in codice ad hoc.
I sistemi agentici affidabili si manifestano quando tutti e 3 i livelli sono progettati intenzionalmente.
Questo è il vero stack architetturale.
Conclusione Finale
La gente continua a parlare degli agenti AI come se la svolta fosse il modello.
In produzione, quello è raramente il vero fattore differenziante.
Il fattore differenziante è il sistema attorno al modello:
- la piattaforma che gli permette di lavorare
- i cicli che gli permettono di migliorare
- il grafo che gli permette di operare sotto controllo
È così che gli agenti giocattolo diventano sistemi reali.
Se sei arrivato a leggere fin qui:
- METTI SEGNALIBRO.
- Segui @LunarResearcher
- Segui il mio Substack
- Segui il mio Canale Telegram Privato
