Архитектуры SWE-Agent и OpenDevin

SWE-Agent и OpenDevin (теперь OpenHands) — ведущие агенты программирования с открытым исходным кодом. Чтение их кода показывает, как работают профессионалы.

SWE-Agent представил концепцию «интерфейса агента и компьютера» (ACI) — тщательно спроектированный CLI, с помощью которого агент изменяет код.

• open / goto / scroll_up / scroll_down — просмотрщик файлов
• edit — редактирование диапазона строк
• create — создание новых файлов
• find_file / search_dir — поиск
• submit — завершение задачи

SWE-Agent показывает модели только 100-строчное «окно» файла за один раз. Это заставляет явно прокручивать файл, что неожиданно помогает сосредоточиться.

После каждого редактирования SWE-Agent запускает статический анализатор. Если появились новые ошибки, редактирование отклоняется, и модель должна повторить попытку.

OpenDevin (переименованный в OpenHands) — мультиагентная платформа, построенная вокруг изолированной среды Docker. Она поддерживает множество серверных реализаций агентов (CodeAct, BrowsingAgent и другие).

• execute_bash — запуск оболочки
• str_replace_editor — редактор в стиле Anthropic
• browse — инструмент браузера для поиска в интернете
• finish — завершение задачи

OpenHands явно представляет шаги агента как пары «Действие → Наблюдение»:

CodeAct (UIUC) показал, что разрешение модели выдавать PYTHON CODE для каждого вызова инструмента, вместо фиксированных вызовов инструментов в формате JSON, часто дает лучшие результаты.

Причина в том, что код естественным образом объединяет операции, а модель может использовать циклы, условия и промежуточные результаты.

OpenAI выпустила Codex CLI — эталонную реализацию агента программирования с открытым исходным кодом. Применяется похожий шаблон: редактор, оболочка, поиск, завершение.

1. Изолированное рабочее пространство Docker для каждой задачи
2. Набор инструментов для чтения, редактирования, запуска и поиска
3. Проверка после каждого редактирования (статический анализ или тест)
4. Ограничение числа шагов (50–100 итераций)
5. Трассировочное журналирование всего

• Формат редактирования: диапазон строк, замена строки или весь файл
• Просмотрщик файлов: прокрутка по окнам или переход к строке
• Память: черновик или заметки в системном запросе
• Периодичность проверки: после каждого шага или в конце

Вы можете создать конкурентоспособного агента программирования на 500–1000 строках Python, объединив:

• Инструменты из урока 2
• Цикл исправления из урока 3
• Этап планирования из урока 1
• Изоляцию из курса 23
• Оценивание из курса 21

SWE-Agent и OpenHands доступны в открытом виде на GitHub. Потратьте день на чтение их основных циклов — это лучшее знакомство с разработкой агентов, которое можно получить.

Какой архитектурный шаблон почти универсален для агентов программирования?

ACI от SWE-Agent, цикл действий и наблюдений OpenHands, код как действие в CodeAct. Читайте их исходный код. Используйте работающие решения. Создайте собственную, более компактную версию.