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)은 고정된 JSON 도구 호출 대신 모델이 모든 도구 호출에 대해 PYTHON CODE를 출력하도록 허용하면 성능이 더 나은 경우가 많다는 것을 보여 주었습니다.

그 이유는 코드가 자연스럽게 조합되고, 모델이 반복문·조건문·중간 결과를 사용할 수 있기 때문입니다.

OpenAI는 오픈 소스 코딩 에이전트의 참고 구현인 Codex CLI를 공개했습니다. 편집기, 셸, 검색, 완료 도구를 사용하는 비슷한 패턴입니다.

1. 작업마다 샌드박스로 격리된 Docker 작업 공간
2. 읽기 / 편집 / 실행 / 검색 도구 모음
3. 편집마다 검증(린트 또는 test)
4. 단계 상한(50~100회 반복)
5. 모든 작업에 대한 추적 기록

• 편집 형식: 줄 범위와 문자열 치환, 전체 파일 방식
• 파일 뷰어: 창 단위 스크롤과 특정 줄로 이동
• 메모리: 임시 메모장과 시스템 프롬프트 메모
• 검증 주기: 단계마다와 마지막에 한 번

다음 요소를 결합하면 500~1000줄의 파이썬으로 경쟁력 있는 코딩 에이전트를 구축할 수 있습니다.

• 2과정의 도구
• 3과정의 수정 반복 과정
• 1과정의 계획 단계
• 23과정의 샌드박스 격리
• 21과정의 평가

SWE-Agent와 OpenHands는 모두 GitHub에 공개되어 있습니다. 이들의 핵심 반복문을 오후 한나절 동안 읽어 보십시오. 에이전트 공학을 배울 수 있는 가장 좋은 방법입니다.

SWE-Agent의 ACI, OpenHands의 행동-관찰 반복 과정, CodeAct의 행동으로서의 코드. 소스 코드를 읽고, 효과적인 부분을 빌려서, 더 간결한 자체 버전을 구축하십시오.