Architetture di SWE-Agent e OpenDevin

SWE-Agent e OpenDevin (ora OpenHands) sono agenti di programmazione open source all'avanguardia. Leggere il loro codice insegna che cosa fanno i professionisti.

SWE-Agent ha introdotto il concetto di "Agent-Computer Interface" (ACI): una CLI progettata con grande precisione per consentire all'agente di manipolare il codice.

• open / goto / scroll_up / scroll_down — visualizzatore di file
• edit — modifica di intervalli di righe
• create — nuovi file
• find_file / search_dir — ricerca
• submit — completamento dell'attività

SWE-Agent mostra al modello solo una "finestra" di 100 righe del file alla volta. Questo impone di scorrere esplicitamente il file e, sorprendentemente, aiuta a mantenere la concentrazione.

Dopo ogni modifica, SWE-Agent esegue un linter. Se compaiono nuovi errori, la modifica viene rifiutata e il modello deve riprovare.

OpenDevin (rinominato OpenHands) è una piattaforma multi-agente basata su una sandbox Docker. Supporta numerosi backend per "agenti" (CodeAct, BrowsingAgent e così via).

• execute_bash — esecuzione della shell
• str_replace_editor — editor in stile Anthropic
• browse — strumento browser per la ricerca sul web
• finish — attività completata

OpenHands rappresenta esplicitamente i passaggi dell'agente come coppie Azione -> Osservazione:

CodeAct (UIUC) ha mostrato che consentire al modello di emettere CODICE PYTHON per ogni chiamata a uno strumento, invece di chiamate a strumenti con JSON fisso, spesso offre prestazioni migliori.

Il motivo è che il codice si compone naturalmente e il modello può utilizzare cicli, condizioni e valori intermedi.

OpenAI ha distribuito Codex CLI, il proprio agente di programmazione open source di riferimento. Il pattern è simile: editor, shell, ricerca e completamento.

1. Workspace Docker isolato per ogni attività
2. Set di strumenti per leggere, modificare, eseguire e cercare
3. Verifica dopo ogni modifica (lint o test)
4. Limiti ai passaggi (50-100 iterazioni)
5. Registrazione di ogni evento in un trace

• Formato delle modifiche: intervallo di righe, sostituzione di stringhe o file completo
• Visualizzatore di file: scorrimento a finestre o salto a una riga
• Memoria: scratchpad o note nel system prompt
• Frequenza delle verifiche: a ogni passaggio o alla fine

Può costruire un agente di programmazione competitivo in 500-1000 righe di Python combinando:

• Gli strumenti della Lezione 2
• Il ciclo di correzione della Lezione 3
• Un passaggio di pianificazione della Lezione 1
• L'isolamento del Corso 23
• La valutazione del Corso 21

Sia SWE-Agent sia OpenHands sono disponibili pubblicamente su GitHub. Dedichi un pomeriggio alla lettura dei loro cicli principali: è la migliore formazione sull'ingegneria degli agenti che possa ricevere.

Qual è un pattern architetturale quasi universale tra gli agenti di programmazione?

L'ACI di SWE-Agent, il ciclo azione-osservazione di OpenHands e il codice come azione di CodeAct. Legga il loro codice sorgente. Riutilizzi ciò che funziona. Costruisca una propria versione più snella.