Agent Farm

🚀 Agent Farm v3.4 - Chunked Write Edition

ツールを備えたエージェントによるAI生物の進化と並列タスク実行。 現在では、大規模なドキュメントやコードファイルを生成するためのChunked Write Patternが搭載されています！

🚀 クイックスタート

Agent Farm v3.4は、ツールを備えたエージェントを用いてAI生物の進化と並列タスク実行を行うことができます。新しいChunked Write Patternにより、大規模なドキュメントやコードファイルの生成が可能です。

✨ 主な機能

v3.4の新機能

• Chunked Write Pattern：バグがセクションを並列に書き、Pythonが直接組み立てます。
• chunked_write：大規模なMarkdown/テキストドキュメントを生成します（サイズ制限なし）。
• chunked_code_gen：複数の関数を持つコードファイルを並列に生成します。
• chunked_analysis：多面的な分析と合成を行います。
• 500文字制限を回避：各バグが小さなチャンクを書き、結合された出力は無制限です。

パフォーマンス

• v3.0より8.6倍高速（4タスクの群れで103秒から12秒）。
• 各タスクにつき1回の反復（以前は3 - 5回）。
• 実際のツールデータで100%成功率。
• ローカル合成 - qwen2.5:14bが結果を合成します（クラウドトークン不要！）。

📦 インストール

cd ~/repos/agent-farm
uv venv
uv pip install -e .

💻 使用例

システムの健全性チェック

agent-farm:system_health_swarm

カスタムタスク群れ

agent-farm:tool_swarm
  colony_type: "heavy"
  tasks: [
    {"prompt": "Check CPU temperature"},
    {"prompt": "List top 5 memory processes"},
    {"prompt": "Check if docker is running"}
  ]

大規模ファイルの直接書き込み

agent-farm:heavy_write
  path: "/tmp/large_output.txt"
  content: "... large content ..."

コードベースの調査

agent-farm:recon_swarm
  target_path: "/home/kyle/repos/my-project"

大規模ドキュメントの生成（チャンク方式）

agent-farm:chunked_write
  output_path: "/tmp/security_guide.md"
  spec: "Linux server security hardening guide"
  num_sections: 5
  doc_type: "markdown"

出力：5つの首尾一貫したセクションを持つ9KB以上のドキュメント

コードファイルの生成（チャンク方式）

agent-farm:chunked_code_gen
  output_path: "/tmp/utils.py"
  spec: "File utilities: read, write, copy, delete"
  language: "python"
  num_functions: 4

出力：4つの関数を持つ完全なPythonモジュール

多面的な分析

agent-farm:chunked_analysis
  target: "/home/kyle/repos/project"
  question: "What are the architectural patterns?"
  num_perspectives: 4

出力：構造、パターン、品質、パフォーマンスの観点からの分析

📚 ドキュメント

モデル

MCPツール (30)

コロニー管理

• spawn_colony - バグコロニーを作成します（標準/高速/重負荷/ハイブリッド）。
• list_colonies - アクティブなコロニーを一覧表示します。
• colony_status - コロニーの詳細情報を表示します。
• quick_colony - コロニーの迅速な健全性チェックを行います。
• dissolve_colony - コロニーを削除します。
• cleanup_idle - アイドル状態のコロニーを削除します。
• farm_stats - 包括的な統計情報を表示します。

群れの展開

• deploy_swarm - タスクをコロニーに展開します。
• quick_swarm - 一度に生成と展開を行います。

特殊な群れ

• code_review_swarm - 4つの観点からのコードレビューを行います。
• code_gen_swarm - コード、テスト、ドキュメントを生成します。
• file_swarm - 並列ファイル操作を行います。
• exec_swarm - 並列シェルコマンドを実行します。
• api_swarm - 並列HTTPリクエストを行います。
• kmkb_swarm - 多角度の知識クエリを行います。

ツールを備えたエージェント

• tool_swarm - 実際のシステムツールを備えたバグを展開します。
• system_health_swarm - システムの迅速な健全性チェックを行います。
• recon_swarm - ディレクトリ/コードベースの調査を行います。
• deep_analysis_swarm - ディスク/ファイルの深い分析を行います。
• worker_task - 完全なツールを備えた単一のワーカーを実行します。

直接操作

• heavy_write - 大規模な内容をLLMを迂回して直接ファイルに書き込みます。
• synthesize - 任意のJSON結果を独立して合成します。

Chunked Write Pattern (新機能)

• chunked_write - 並列セクション書き込みにより大規模なドキュメントを生成します。
• chunked_code_gen - 関数を並列に書き込むことでコードファイルを生成します。
• chunked_analysis - 多面的な分析と合成を行います。

バグツールの権限

構造化出力の詳細

Agent Farm v3.3はOllamaの構造化出力機能を使用して、モデルの応答にJSONスキーマを適用します。

# バグは保証された有効なJSONで応答します：
{"tool": "system_status", "arg": ""}
{"tool": "exec_cmd", "arg": "df -h"}
{"tool": "check_service", "arg": "ollama"}

制約付きデコード（GBNF文法）は、生成中に無効なトークンをマスクし、以下を保証します。

• 常に有効なJSON
• 正しいツール名
• 適切な引数構造
• 解析エラーなし

結果には、使用された方法を示すmodeフィールドが含まれます。

• structured - JSONスキーマが適用されます。
• structured+autoformat - JSON + 単純な結果整形
• structured+deep - 多段階の推論を伴うJSON
• regex - フォールバックの正規表現解析
• regex+autoformat - 正規表現 + 単純な結果整形

Chunked Write Pattern

Chunked Write Patternは、小さなモデルの約500文字の出力制限を解決するために、大きなタスクを分解します。

1. PLANNER BUG (qwen2.5:14b)
   |-- 構造化されたJSONアウトラインを作成します。
   |-- {"sections": [{"title": "...", "description": "..."}]}

2. WORKER BUGS (qwen3:4b) - 並列実行
   |-- 各バグが1つのセクションを書きます（約300 - 500文字）。
   |-- 4つのワーカー = 4つのセクションを同時に書きます。

3. PYTHON CONCATENATION (LLMなし)
   |-- ヘッダ + セパレータ.join(セクション)
   |-- トークンコストがゼロで、即座に組み立てられます。

4. DIRECT FILE WRITE (LLMなし)
   |-- tool_write_file()で結果を保存します。
   |-- 出力の破損を回避します。

パフォーマンス

動作原理

• 小さなモデルは、集中的な短い出力に優れています。
• 各セクションは「安全圏」（<500文字）内に収まります。
• Pythonが組み立てを処理します（LLMのトークンコストなし）。
• ThreadPoolExecutorを介した並列実行。
• 構造化出力により信頼性の高い計画が保証されます。

Claude Desktopの設定

{
  "mcpServers": {
    "agent-farm": {
      "command": "/home/kyle/repos/agent-farm/.venv/bin/python",
      "args": ["-m", "agent_farm.server"]
    }
  }
}

変更履歴

v3.4.0 (2026-01-23)

• Chunked Write Pattern - バグがセクションを並列に書き、Pythonが組み立てます。
• chunked_write - 無制限サイズのドキュメントを生成します（テスト済み：78秒で9.6KB）。
• chunked_code_gen - 複数の関数を持つコードファイルを並列に生成します。
• chunked_analysis - 多面的な分析と合成を行います。
• タスク分解により500文字のバグ制限を回避します。
• プランナーは信頼性の高いアウトラインのために構造化されたJSON出力を使用します。

v3.3.0 (2026-01-23)

• Ollama Structured Output - 制約付きデコードによるJSONスキーマの適用。
• 信頼性の高いツール解析 - 正規表現の失敗がなくなりました。
• モード追跡 - 結果に使用された解析方法が表示されます。
• 正規表現フォールバック - レガシー解析はバックアップとして引き続き利用可能です。
• すべての役割に複雑なシェルクエリのためのexec_cmdが付与されます。

v3.2.0 (2026-01-22)

• Synthesizer役割 - 正確な結果合成のためのqwen2.5:14b。
• synthesizeパラメータ - tool_swarm、system_health_swarm、recon_swarm、deep_analysis_swarmに追加されました。
• synthesizeツール - 任意のJSON結果を独立して合成します。
• Claude合成税がなくなりました - バグがすべての作業をローカルで行います。

v3.1.0 (2026-01-20)

• 8.6倍の速度向上（103秒から12秒）。
• 自動整形により冗長なLLM呼び出しをスキップします。
• 無効なツールを即座に拒否します。
• 回答前にツールの使用を強制します。
• 複雑なシェルコマンドのサポートが修正されました。
• すべての役割が最低でもqwen3:4bにアップグレードされました。

v3.0.0 (2026-01-19)

• WindowsバージョンからのLinux再構築。
• 役割権限を持つツールを備えたエージェント。
• システムの健全性、調査、ワーカー群れ。
• ThreadPoolExecutorによる真の並列実行。