Architettura degli agenti AI: gli schemi che reggono in produzione
Le discussioni di architettura partono di solito dal lato sbagliato: un diagramma di caselle chiamate come concetti. La versione utile parte dal guasto che volete evitare, perché ogni schema qui sotto esiste per impedire un preciso pomeriggio storto.
Questi sei sono quelli a cui torniamo sempre. Si compongono: un agente in produzione è tipicamente un ciclo limitato con gateway degli strumenti, due livelli di memoria e un cancello umano, più un passaggio critico solo dove il costo di sbagliare giustifica un'altra chiamata.
1. Il ciclo limitato#
Il caso base e la vostra impostazione predefinita. Un ciclo su un piccolo insieme di strumenti con condizioni di arresto esplicite: tetto di passi, tetto di spesa, rilevazione delle ripetizioni e limite di tempo. Il suo pregio è una traccia lineare leggibile dall'alto in basso.
Se non riuscite a disegnare il vostro agente come un ciclo con un elenco di uscite, non avete ancora un'architettura: avete un prompt ambizioso.
2. Pianificatore–esecutore con ripianificazione#
Per compiti oltre i cinque passi, chiedete prima un piano numerato, eseguitelo e ripianificate al fallimento invece di seguire un piano stantio. Il vantaggio non è l'accuratezza: è che una persona vede l'intenzione prima dell'azione, il che rende possibili approvazione e debug.
3. Il passaggio critico#
Una seconda chiamata rivede la bozza o l'azione proposta rispetto all'obiettivo e alle prove recuperate, e può rimandarla indietro una volta. Cattura una quota reale di output sicuri ma non supportati. Usatelo dove un risultato sbagliato è costoso e una chiamata in più no.
| Schema | Chiamate extra | Cosa dà | Saltare se |
|---|---|---|---|
| Ciclo limitato | 0 | Tracciabilità, controllo dei costi | Mai: è la base |
| Pianificatore–esecutore | 1–2 | Intenzione visibile, verificabilità | Compiti sotto i cinque passi |
| Passaggio critico | 1 per output rivisto | Meno affermazioni non supportate | Output economici e reversibili |
| Gateway degli strumenti | 0 | Permessi, audit, limiti | Solo prototipi |
| Memoria a livelli | 0–1 | Pertinenza con contesto lungo | Esecuzioni brevi |
| Cancello umano | 0 | L'irreversibile resta sicuro | Se nulla è irreversibile |
4. Il gateway degli strumenti#
Non lasciate che l'agente chiami i vostri sistemi direttamente. Mettete davanti a ogni strumento un livello che faccia quattro cose: validare gli argomenti contro uno schema, verificare che quell'utente finale possa toccare quel record, applicare un limite di frequenza e scrivere una riga di audit con l'identificativo dell'esecuzione.
5. Memoria a livelli#
Una cronologia indifferenziata è la causa più comune di un agente che peggiora nel corso di un'esecuzione. Separate: obiettivo e vincoli, mai potati; turni recenti alla lettera; turni vecchi compressi in brevi note fattuali; e conoscenza recuperata, presa per passo e mai accumulata.
6. Il cancello umano#
Ogni azione irreversibile sta dietro un'approvazione esplicita con contesto sufficiente a decidere in pochi secondi. Il cancello è una funzione di prodotto, non un limite: è ciò che vi permette di andare in produzione dove gli errori costano.
Domande frequenti
Servono tutti e sei gli schemi?
No. Iniziate con ciclo limitato e gateway; entrambi sono quasi obbligatori per qualsiasi cosa tocchi sistemi reali.
Il passaggio critico migliora davvero l'accuratezza?
Nei compiti dove il modello può produrre risposte plausibili ma non supportate, sì in modo apprezzabile.
Dove deve stare il gateway?
Nel vostro servizio, fra agente e sistemi, con l'identità dell'utente finale che lo attraversa.
architettura agenti aischemi di design agentipianificatore esecutoregateway strumentimemoria agente
