Codified Context: Infrastructure for AI Agents in a Complex Codebase
Questo articolo presenta un'infrastruttura di contesto codificato composta da tre elementi, sviluppata per un sistema distribuito C# di grandi dimensioni, che risolve il problema della mancanza di memoria persistente negli agenti di codifica basati su LLM garantendo coerenza e prevenzione degli errori attraverso sessioni di sviluppo multiple.
Articolo originale sotto licenza CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Questa è una spiegazione generata dall'IA dell'articolo qui sotto. Non è stata scritta né approvata dagli autori. Per precisione tecnica, consulta l'articolo originale. Leggi il disclaimer completo
Immagina di dover costruire un grattacielo di 108.000 piani (il tuo codice software) usando un architetto geniale ma con una memoria molto corta: ogni volta che lo chiami, dimentica tutto ciò che hai fatto la volta prima, le regole che avevi stabilito e gli errori che avevi già commesso. Questo è il problema principale degli attuali assistenti di programmazione basati sull'Intelligenza Artificiale (AI).
Questo paper racconta come l'autore, un chimico che non è un esperto di informatica, ha risolto questo problema costruendo un sistema per "istruire" l'AI in modo che non dimentichi mai nulla, permettendogli di costruire quel grattacielo da solo in meno di 70 giorni.
Ecco come funziona, spiegato con delle metafore semplici:
Il Problema: L'Amnesia dell'AI
Pensa all'AI come a un tessitore molto veloce, ma che ha la memoria di un pesce rosso. Se gli dai un filo alla volta, fa un bel lavoro. Ma se gli chiedi di tessere un arazzo gigante (un progetto software complesso), dopo un po' dimentica il disegno, usa colori sbagliati e ripete gli stessi errori.
Fino a poco tempo fa, gli sviluppatori provavano a risolvere questo problema con un semplice "biglietto da visita" (un file di testo) che spiegava all'AI cosa fare. Ma per un progetto enorme, un solo foglio di carta non basta: è come cercare di spiegare le regole di un'intera nazione su un post-it.
La Soluzione: L'Infrastruttura di "Contesto Codificato"
L'autore ha creato un sistema a tre livelli, come una biblioteca intelligente o un quartier generale militare, dove l'AI attinge informazioni diverse a seconda di cosa deve fare.
1. Livello 1: La "Costituzione" (La Memoria Calda)
Immagina un manuale di istruzioni fondamentale che l'AI legge ogni volta che si sveglia, come se fosse il suo risveglio mattutino.
- Cosa contiene: Le regole d'oro, i nomi delle cose, come costruire le fondamenta e cosa non fare mai.
- Metafora: È come la Costituzione di un paese. È breve, sempre presente e nessuno può ignorarla. Dice all'AI: "Ricorda, qui si guida a sinistra e non si possono costruire case senza permessi".
2. Livello 2: Gli "Agenti Specialisti" (I Consulenti Esperti)
Quando il lavoro diventa specifico, l'AI non usa un esperto generico, ma chiama un super-esperto specifico per quel compito.
- Cosa sono: Ci sono 19 "agenti" diversi. Uno è un esperto di reti, uno di grafica, uno di sicurezza. Ognuno ha un portafoglio pieno di conoscenze specifiche sul progetto.
- Metafora: Immagina di dover riparare un'auto. Non chiami un meccanico generico; chiami lo specialista dei freni o lo specialista del motore. Questi specialisti hanno già in testa (nella loro "memoria") tutti i problemi noti di quel pezzo specifico, così non devono imparare da zero ogni volta.
3. Livello 3: La "Biblioteca di Conoscenza" (La Memoria Fredda)
Quando serve un dettaglio tecnico molto profondo, l'AI va a cercare un documento specifico in una biblioteca.
- Cosa sono: 34 documenti scritti apposta per le macchine, che spiegano in dettaglio come funziona ogni singolo pezzo del sistema.
- Metafora: È come una biblioteca di manuali tecnici. Se devi sapere come funziona esattamente il sistema di frenatura, l'AI va a prendere il manuale specifico, lo legge velocemente e lo applica. Non deve leggere tutto il libro, solo il capitolo che le serve.
Come funziona nella pratica?
L'autore ha creato un "sistema di gestione" che funziona così:
- Tu (il umano) fai una domanda all'AI.
- L'AI legge subito la Costituzione (Livello 1) per capire le regole.
- Se la domanda è complessa, il sistema guarda una tabella di routing (come un centralino) e decide quale Specialista (Livello 2) chiamare.
- Lo specialista, se ha bisogno di dettagli, va a cercare il documento giusto nella Biblioteca (Livello 3).
Perché è geniale?
- Non perde il filo: Anche dopo mesi, l'AI ricorda le regole e i dettagli perché sono scritti in questi documenti, non nella sua memoria temporanea.
- Impara dagli errori: Se l'AI sbaglia qualcosa, l'autore scrive la correzione nel documento dello specialista. La prossima volta, lo specialista saprà già come evitare quell'errore. È come se l'azienda avesse un "registro degli errori" che tutti leggono.
- Risparmia tempo: Invece di spiegare all'AI ogni volta come funziona una cosa, gli basta leggere il documento.
La Conclusione
Questo paper ci dice che per costruire cose grandi con l'AI, non basta darle un prompt intelligente. Dobbiamo costruire un'infrastruttura di conoscenza (documenti, regole, esperti virtuali) che l'AI possa consultare.
È come se invece di avere un solo apprendista che dimentica tutto, avessimo un'intera squadra di artigiani con i loro manuali, le loro regole scritte e la loro esperienza condivisa, tutti pronti a lavorare sotto la tua direzione. Questo permette anche a chi non è un esperto di programmazione (come l'autore, che è un chimico) di costruire software complessi e affidabili.
Sommerso dagli articoli nel tuo campo?
Ricevi digest giornalieri degli articoli più recenti corrispondenti alle tue parole chiave di ricerca — con riassunti tecnici, nella tua lingua.