← プロジェクト一覧に戻る

ChatDev
エージェント、スクリプト、人の確認をノードと線でつなぐ実行基盤。画面でもYAMLでも組める
公式Apache-2.0
ChatDevとは
ChatDev 2.0は、エージェント、Python実行、人の確認、別ワークフローの埋め込みといったノードを線でつなぎ、分岐や繰り返しを含む1枚の図として多エージェント構成を設計する基盤です。ブラウザのLaunch画面から実行を始めると、各ノードが待機・実行中・成功または失敗と変わる様子を追え、途中で人が指示を返すこともでき、同じYAMLをPyPIのchatdevパッケージから画面なしで動かすこともできます。2023年の論文で知られる仮想のソフトウェア会社も消えたわけではなく、CEO、プログラマー、コードレビュアー、テスト担当など9つのエージェントを組んだサンプルワークフローとして2.0にも同梱されていますが、論文当時の実装そのものは別ブランチへ移っています。ただし基盤自体は新しく、付属ドキュメントとコードで設定項目の名前が食い違う箇所も残っているため、説明文よりも同梱のYAMLを読んで覚える前提で臨んでください。
ChatDevで何ができますか?
- ノードと線でワークフローを組む — make devでバックエンドとWebコンソールが同時に立ち上がり、localhost:5173の画面でノードと線を並べて組み立て、YAMLとして書き出せます。逆にyaml_instance/配下のYAMLを直接書いてもよく、同梱のサンプルは40本ほど、実行前にmake validate-yamlsでまとめて検証できます。
- モデルはノード単位で選ぶ — エージェントノードはprovider、base_url、api_keyに加えて、モデル名を指すnameをノードごとに持ちます。下書きは安いモデル、レビューは強いモデルという配分ができ、base_urlをOllamaやLM Studioに向ければ実行全体を手元のマシンで完結させられます。なおモデル名の項目をmodelと書いた公式ドキュメントが残っていますが、それでは設定エラーになります。
- エージェント以外のノードで流れを作る — humanノードは人が答えるまで実行を止め、ファイルの添付も受け付けます。pythonノードは直前のメッセージに含まれるコードブロックを取り出し、共有のcode_workspace/で実行します。subgraphノードは別のワークフローを丸ごと埋め込み、loop_counterとloop_timerは決めた回数や時間に達するまで出力を抑えて、繰り返しの出口を握ります。
- エージェントに記憶を持たせる — simpleは検索できる会話履歴で、JSONファイルに残すこともできます。fileは手元の文書を分割して索引化した読み取り専用のナレッジベースで、元のファイルが変われば作り直されます。blackboardは検索を持たない新しい順の記録、mem0は保存先をMem0のクラウドに預ける方式です。
- 自作の関数やMCPサーバーをツールにする — 型注釈を付けた関数をfunctions/function_calling/に置くと、バックエンドの起動時に呼び出し仕様が組み立てられます。画面の選択肢にも出すにはテンプレート書き出しのコマンドを別途実行します。MCPサーバーはHTTP経由でも、標準入出力で話すローカルプロセスとしても接続でき、Blenderのサンプルは後者でblender-mcpを呼んでいます。
- 1本のエッジで並列に広げる — エッジにdynamicを付けると、受け取り側のノードが並列のコピーに展開されます。mapは流れてきたメッセージを分割して1件ずつ並列に処理し、treeはそのうえで結果をグループごとにまとめて1つになるまで畳み込むため、長文の要約に向きます。分割はメッセージ単位、正規表現、JSONパスから選べ、同時実行数の既定は10で、API呼び出しが大きく増える点は公式ドキュメントも注意しています。
ChatDevを選ぶ前に
- 2023年の論文で知られる仮想ソフトウェア会社は2.0ではサンプルワークフローの1つとして作り直され、当時の実装が残るchatdev1.0ブランチは2024年12月以降ニュース文しか更新されていません。
- pythonノードは受け取ったメッセージ内のコードをそのままバックエンドのマシン上で普通のプロセスとして実行し、既定60秒の時間制限しか歯止めがないため、隔離したいならバックエンドごとコンテナで動かすことになります。
スター推移
8月17日〜10月30日 · +612
34k34.6k
よくある質問
ChatDevは商用利用できますか?
ChatDevはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。
ChatDevはどの形で使えますか?
ChatDevはセルフホスト・ローカル実行の形で利用できます。