26ツールコール、1スクリプト、0.02ドル——「コードモード」の驚異的なトークン節約
Agent Swarmが「コードモード」を実測：AIエージェントが個別のツール呼び出しではなくスクリプトでAPIを一括処理すると、コンテキストサイズが99.2%削減、実行速度が30倍、コストが2.44ドルから2セントに。
60秒でわかる
Agent Swarmが「コードモード」を実測——スクリプトにバルクAPI呼び出しを処理させ、エージェントが個別ツール呼び出しをするのを避ける方式——コンテキストサイズとコストを99.2%削減。
要点
- workflow-triageスクリプトは内部で26回の呼び出しを行い、エージェントには25,811文字のみを渡す——順次呼び出しの約326万文字と比較して126倍の削減。
- 経過時間は2～6.5分（推定）から13.12秒に——約30倍の高速化。
- コストは2.44ドル（下限、1ターン価格）から0.02ドルに——実際の順次パスコストはコンテキスト蓄積のためさらに高い。
- 結果はAnthropic（98.7%）およびCloudflare（99.9%）の公表値と一致し、標準の収束を示唆している。
結論. コードモード——API呼び出しをスクリプトにバンドルし、蒸留された結果のみをモデルに渡す——最初の複数呼び出しタスクで効果を発揮する必須の最適化。数字がすべてを物語っている。
問題ツール呼び出しがコンテキストを污染するとき
AIエージェントがツールを呼び出すたびに——ワークフローリストの取得、スケジュールの確認、API結果の読み取り——完全な生のJSONレスポンスがモデルのコンテキストウィンドウに入り、そこに残り続けます。後続のターンごとに再送信されます。26回の順次呼び出しが必要なタスクでは、26のペイロードがメモリに蓄積され、それぞれがトークンと金銭を消費します。
これは業界が数ヶ月間取り組んできた問題です。Anthropicは2025年11月に、エージェントにサンドボックスクリプト環境と生成APIを提供することで、150,000トークンのタスクをわずか2,000に削減できることを示しました——98.7%の削減、生データがモデルのコンテキストを通過する必要がまったくなくなるためです。Cloudflareは2025年9月に「コードモード」として同じアイデアをリリースし、後に2,500以上のAPIエンドポイントで117万トークンから約1,000への削減を報告しました。
実験Workflow Triage——1スクリプト vs 26の順次呼び出し
Agent Swarmのテスト対象はworkflow-triage、全プロダクションスウォームをスキャンしてワークフローとcronスケジュールの死活状態をチェックするスクリプトです。内部では26のAPI呼び出しを行います：1回のworkflow_list、1回のschedule_list、ワークフローごとに1回のworkflow_listRuns（24個）。
スクリプトパス
スクリプトは独自のサンドボックサブプロセス内で実行され、26回すべての呼び出しを内部で行い、1つのサマリーオブジェクト（25,811文字）だけをエージェントに返します。生データはモデルの貴重なコンテキストウィンドウに触れません。経過時間：13.12秒。
生の順次パス
エージェントが手動で同じ作業を行う場合、26回の個別ツール呼び出しが必要です。毎回の生JSONレスポンスが会話中コンテキストに残ります。Agent Swarmは同じSDKメソッドを直接呼び出して実際のペイロードサイズを測定しました：workflow_listは16,304文字、schedule_listは72,105文字、4つのサンプリングワークフロー（312回の実行）では、workflow_listRunsの平均レスポンスが実行あたり3,447文字でした。全24のワークフローの実際の総実行回数920回に適用すると、実行データだけで約317万文字になります。生パスの推定総トークン数は約815,000、経過時間は約2から6.5分と推定されます。
結果99.2%削減——実際のコストで測定
スクリプト自身の数値は100%実測です——durationMs: 13120と25,811文字の出力は実際の実行から直接取得されました。生パスの文字数は実測後に外插されています：スクリプトが使用するのとまったく同じSDKメソッドを呼び出し、最小と最大のワークフローをサンプリングし、実測平均をスウォームの記録実行回数に適用しました。
技術コードモードとスクリプトワークフロー
Agent Swarmのアプローチはこのブログ記事よりも前から存在します。スウォーム内のclaude/codex/opencodeセッションにはすべてルーブリック（system.agent.context_mode）が組み込まれており、エージェントに指示します：10項目以上または一括ファンアウトの場合は、N回の個別ツール呼び出しではなくスクリプトを使用せよ。同じメカニズムがスクリプトワークフロー機能を支えており、自動化パイプライン全体がエージェントのコンテキスト外で構成可能なスクリプトとして実行されます。
コアインサイトは簡単です：エージェントが26のツールを呼び出してコンテキストに生JSONを填てる代わりに、エージェントが1つのツール——スクリプト実行器——を呼び出し、スクリプトが内部で26回の呼び出しを行います。モデルは精煮された結果のみを視ています。データベースクエリが行ごとのフェッチよりも安価なのと同じ原理です：バッチ処理し、答えだけを伝送する。
重要性ひとつのベンチマークを超えて
これらの数字はAgent Swarmの環境に固有のものではありません。同じパターンは、エージェントが複数のAPI呼び出しを必要とするあらゆる場面に適用できます：サービス間でのユーザーデータ取得、複数エンドポイントのポーリング、ページングされたリストの結果集約、クラスター全体のヘルスチェック。生データが分析結果より大きい限り、処理をスクリプト内に移動することでコンテキストが節約され、コストと時間が削減されます。
Anthropicの98.7%、2,500エンドポイントでのCloudflareの99.9%、そして本番ワークロードでのAgent Swarmの99.2%——このパターンは収束しています。コードモードは、名称はともかく、効率的なAIエージェントの標準アーキテクチャパターンになりつつあります。