Architectures de SWE-Agent et OpenDevin

SWE-Agent et OpenDevin (désormais OpenHands) sont des agents de programmation open source de premier plan. La lecture de leur code vous apprend les pratiques des experts.

SWE-Agent a introduit le concept d’« interface agent-ordinateur » (ACI) : une CLI conçue avec précision pour permettre à l’agent de manipuler le code.

• open / goto / scroll_up / scroll_down — afficheur de fichiers
• edit — modification par plage de lignes
• create — nouveaux fichiers
• find_file / search_dir — recherche
• submit — terminer la tâche

SWE-Agent ne montre au modèle qu’une « fenêtre » de 100 lignes d’un fichier à la fois. Cela impose un défilement explicite, ce qui aide étonnamment à rester concentré.

Après chaque modification, SWE-Agent exécute un analyseur statique. Si de nouvelles erreurs apparaissent, la modification est rejetée et le modèle doit réessayer.

OpenDevin (renommé OpenHands) est une plateforme multi-agents construite autour d’un bac à sable Docker. Elle prend en charge de nombreux moteurs d’agent (CodeAct, BrowsingAgent, etc.).

• execute_bash — exécuter des commandes shell
• str_replace_editor — éditeur de style Anthropic
• browse — outil de navigation pour les recherches sur le Web
• finish — tâche terminée

OpenHands modélise explicitement les étapes de l’agent sous forme de paires Action -> Observation :

CodeAct (UIUC) a montré que laisser le modèle produire du CODE PYTHON pour chaque appel d’outil, plutôt que d’utiliser des appels d’outils JSON fixes, donne souvent de meilleurs résultats.

Raison : le code se compose naturellement, et le modèle peut utiliser des boucles, des conditions et des résultats intermédiaires.

OpenAI a publié Codex CLI, son agent de programmation open source de référence. Le schéma est similaire : éditeur, shell, recherche, terminaison.

1. Espace de travail Docker isolé pour chaque tâche
2. Ensemble d’outils pour lire, modifier, exécuter et rechercher
3. Vérification après chaque modification (analyse statique ou test)
4. Plafonds d’étapes (50 à 100 itérations)
5. Journalisation des traces pour tout

• Format de modification : plage de lignes, remplacement de chaîne ou fichier complet
• Afficheur de fichiers : défilement par fenêtre ou saut à une ligne
• Mémoire : bloc-notes ou notes dans l’invite système
• Rythme des vérifications : à chaque étape ou à la fin

Vous pouvez construire un agent de programmation compétitif en 500 à 1 000 lignes de Python en combinant :

• Les outils de la leçon 2
• La boucle de correction de la leçon 3
• Une étape de planification de la leçon 1
• L’isolation en bac à sable du cours 23
• L’évaluation du cours 21

SWE-Agent et OpenHands sont tous deux publiés sur GitHub. Consacrez un après-midi à la lecture de leurs boucles principales : c’est la meilleure formation en ingénierie des agents que vous puissiez recevoir.

Quel est le motif architectural presque universel parmi les agents de programmation ?

L’ACI de SWE-Agent, la boucle action-observation d’OpenHands et le code comme action de CodeAct. Lisez leur code source. Reprenez ce qui fonctionne. Construisez votre propre version plus légère.