SWE-AgentとOpenDevinのアーキテクチャ

SWE-Agent と OpenDevin（現在の OpenHands）は、代表的なオープンソースのコーディングエージェントです。これらのコードを読むと、熟練者がどのように実装しているかを学べます。

SWE-Agent は「Agent-Computer Interface」（ACI）という概念を導入しました。これは、エージェントがコードを操作するために綿密に設計されたCLIです。

• open / goto / scroll_up / scroll_down — ファイルビューアー
• edit — 行範囲の編集
• create — 新しいファイルの作成
• find_file / search_dir — 検索
• submit — タスクを完了する

SWE-Agent は、一度にファイルの100行分の「window」だけをモデルに表示します。明示的なスクロールを強制することで、意外にも集中しやすくなります。

SWE-Agent は編集のたびにリンターを実行します。新しいエラーが発生した場合、編集は拒否され、モデルは再試行しなければなりません。

OpenDevin（OpenHands に改称）は、Docker サンドボックスを中心に構築されたマルチエージェントプラットフォームです。複数の「エージェント」バックエンド（CodeAct、BrowsingAgent など）をサポートしています。

• execute_bash — シェルを実行する
• str_replace_editor — Anthropicスタイルのエディター
• browse — Web調査用のブラウザーツール
• finish — タスク完了

OpenHands は、エージェントのステップを Action -> Observation のペアとして明示的にモデル化します：

CodeAct（UIUC）は、固定されたJSONツール呼び出しではなく、すべてのツール呼び出しでモデルに PYTHON CODE を出力させると、多くの場合より優れた結果になることを示しました。

理由は、コードは自然に組み合わせられ、モデルがループや条件分岐、中間値を利用できるためです。

OpenAI は Codex CLI を公開しました。これは同社のオープンソースのコーディングエージェントのリファレンス実装です。エディター、シェル、検索、完了という似たパターンを採用しています。

1. タスクごとにサンドボックス化されたDockerワークスペース
2. Read / edit / run / search のツールセット
3. 編集ごとの検証（lintまたはテスト）
4. ステップ数の上限（50～100回の反復）
5. すべてを対象としたトレースログ

• 編集形式：行範囲、文字列置換、ファイル全体
• ファイルビューアー：ウィンドウ単位のスクロール、行へのジャンプ
• メモリ：スクラッチパッド、システムプロンプトのメモ
• 検証の頻度：ステップごと、最後にまとめて

次の要素を組み合わせれば、500～1000行のPythonで競争力のあるコーディングエージェントを構築できます：

• レッスン2のツール
• レッスン3の修正ループ
• レッスン1の計画ステップ
• コース23のサンドボックス化
• コース21のEval

SWE-Agent と OpenHands はどちらもGitHubで公開されています。午後の時間を使ってメインループを読んでみてください。エージェントエンジニアリングについて得られる最高の学びです。

コーディングエージェントにほぼ共通するアーキテクチャパターンは何ですか？

SWE-Agent の ACI、OpenHands のアクションと観測のループ、CodeAct のコード・アズ・アクション。ソースを読み、うまくいくものを取り入れ、よりスリムな独自バージョンを構築してください。