Context Engineering for AI Agents in Open-Source Software
Questo articolo presenta uno studio preliminare di 466 progetti open-source per investigare l'adozione, la struttura dei contenuti e l'evoluzione dei file AGENTS.md, rivelando una variazione significativa nel modo in cui gli sviluppatori forniscono contesto per gli agenti IA e sottolineando il potenziale per ricerche future sull'ottimizzazione dell'ingegneria del contesto per migliorare la qualità del codice generato.
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 assumere un nuovo stagista brillante e velocissimo per aiutarti a costruire una macchina complessa. Questo stagista è un agente IA. Se dici semplicemente: "Ripara il motore", potrebbe sbagliare perché non conosce le tue regole specifiche, i tuoi strumenti preferiti o come lavora di solito il tuo team.
Questo articolo parla di un nuovo modo per fornire a quel tirocinante un "manuale d'uso" scritto specificamente per un robot, non per un essere umano.
Ecco la suddivisione della ricerca in termini semplici:
Il Problema: Lo stagista ha bisogno di un manuale
In passato, gli sviluppatori di software utilizzavano strumenti come GitHub Copilot per aiutare a scrivere codice. Ora, abbiamo gli "Agenti IA" che possono svolgere più lavoro da soli, come correggere bug o costruire intere funzionalità. Ma proprio come un dipendente umano, un'IA deve comprendere la cultura aziendale e le regole per fare un buon lavoro.
I fornitori (le aziende che producono l'IA) hanno suggerito che gli sviluppatori creino un file speciale nella cartella del loro progetto. Pensa a questo file come a un "Manuale del Dipendente" digitale per l'IA. Esso dice all'IA cose come:
- "Nominiamo sempre le nostre variabili in questo modo."
- "Non toccare mai direttamente il file principale."
- "Ecco come testiamo il nostro codice."
Recentemente, è stato creato un formato standard chiamato AGENTS.md affinché tutti questi strumenti di IA potessero leggere lo stesso tipo di manuale.
Lo Studio: Controllare i manuali
I ricercatori volevano vedere se i progetti software reali stessero effettivamente utilizzando questi manuali e, in caso positivo, come apparissero. Hanno intrapreso una caccia al tesoro digitale attraverso 10.000 progetti software open-source (progetti in cui il codice è libero per chiunque lo veda e lo usi).
1. Quante persone li stanno usando? (Adozione)
Hanno scoperto che solo 466 progetti (circa il 5%) avevano creato uno di questi manuali per l'IA.
- Analogia: È come entrare in un enorme edificio per uffici con 10.000 stanze e scoprire che solo poche stanze hanno esposto un cartello "Nuove Regole per i Nuovi Dipendenti". Siamo ancora ai primissimi stadi di questa tendenza.
2. Cosa c'è dentro i manuali? (Contenuto e Stile)
I ricercatori hanno esaminato da vicino i 155 file AGENTS.md che hanno trovato. Hanno scoperto due cose principali:
Nessuna ricetta standard: Non esiste un unico modo "corretto" per scrivere questi file. Alcuni sono brevi, altri sono lunghi. Alcuni elencano regole, altri descrivono solo come funzionano le cose.
Diverse "Voci": Il modo in cui gli sviluppatori parlano all'IA varia enormemente. I ricercatori hanno categorizzato gli stili di scrittura in cinque tipi:
- Descrittivo: "Ecco come facciamo le cose." (Si limitano a dichiarare i fatti)
- Prescrittivo: "Fallo in questo modo." (Danno ordini diretti)
- Proibitivo: "NON fare questo." (Stabiliscono dei confini)
- Esplicativo: "Fai questo perché..." (Danno una ragione)
- Condizionale: "Se accade X, allora fai Y." (Forniscono una logica situazionale)
Analogia: Immagina 155 diversi manager che cercano di scrivere un libro di regole per lo stesso stagista. Un manager scrive un elenco severo di "Cosa non fare", un altro racconta una storia amichevole su come funziona il team, e un terzo crea un complesso diagramma di flusso "Se/Allora". Non c'è ancora coerenza.
3. I manuali cambiano nel tempo? (Evoluzione)
I ricercatori hanno tracciato come questi file sono cambiati nel tempo osservando la "cronologia dei commit" (il registro del controllo delle versioni).
- Stabilità: Circa la metà dei file non è mai stata modificata dopo la sua creazione iniziale.
- Apporti: Per i file che erano stati modificati, gli aggiornamenti più comuni erano l'aggiunta di nuove istruzioni o l'affinamento di quelle esistenti.
- Analogia: Una volta che un manager scrive il libro delle regole, spesso lo lascia stare. Ma quando lo aggiorna, si tratta solitamente solo di aggiungere una nuova regola o chiarire una vecchia, piuttosto che riscrivere tutto il contenuto.
La Grande Conclusione
L'articolo conclude che siamo attualmente in una fase di "Far West" dell'Ingegneria del Contesto. Gli sviluppatori stanno sperimentando il modo di parlare agli agenti IA, ma non si sono ancora assestati su un modo standard per farlo.
I ricercatori vedono questi file come un "laboratorio naturale" unico. Poiché questi file sono pubblici e soggetti a controllo delle versioni, possiamo osservare in tempo reale come gli esseri umani imparano a "parlare" agli agenti IA. L'obiettivo non è dire agli sviluppatori cosa fare in questo momento, ma capire come stanno affrontando la questione attualmente, in modo da poterli aiutare a farlo meglio in futuro.
In breve: Gli sviluppatori stanno iniziando a scrivere libri di regole per i loro aiutanti IA, ma al momento ogni libro di regole è diverso e nessuno sa ancora quale stile funzioni meglio.
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.