3 つのファイルが必要なエージェントが、1 往復ごとに 1 つずつ頼む必要はありません。並列ツール呼び出しを使えば、モデルは 3 つを一度に要求します。
仕組み
ツール呼び出しの応答では、message.tool_calls はリストです。並列呼び出しの場合はエントリが複数あり、それぞれが独自の id、関数名、JSON 引数を持ちます。
"tool_calls": [
{"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
{"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]
コードで呼び出しを実行し、呼び出しごとに対応する tool_call_id を付けた tool メッセージを 1 つずつ追加してから、もう一度モデルを呼び出します。
- OpenAI:
parallel_tool_callsのデフォルトはtrueです。falseにすると “ensures exactly zero or one tool is called.”(訳:ツールの呼び出しがちょうど 0 個か 1 個になることを保証します。)ガイドは、あるモデルのスナップショットが同じツールを繰り返し呼び出すことがあったと注意し、そこではこの機能を無効にするよう勧めています。 - Anthropic: 並列使用はデフォルトで有効です。tool_choice オブジェクトの中で
disable_parallel_tool_use: trueを指定すると無効になります。Anthropic は、API は “doesn’t prescribe an execution order”(訳:実行順序を規定しない)とし、並列性を保つにはすべてのツール結果を 1 つの user メッセージで返すべきだとしています。
なぜ重要か
- レイテンシ。 モデルとの往復が減ります。互いに独立した読み取り専用のツールは、手元で同時に実行できます。
- 順序。 書き込みのあとに読み込むなど、副作用のある呼び出しは互いに依存することがあります。Anthropic はそうした呼び出しを順番に実行するよう勧めています。あるいは機能を無効にします。
- 管理。 すべての呼び出しに、正しい ID の結果が必要です。結果の欠落は、次のリクエストが失敗するよくある原因です。
BroadNet Inference の場合
BroadNet の API リファレンスは、GLM 5.3 と Qwen3.8 27B のツール呼び出しを記載していますが、parallel_tool_calls は記載していません。自分のプロンプトで複数の呼び出しが返るか、false が守られるかをテストしてください。並列呼び出しは 1 回の応答で届くため、リクエスト数は増えません。ツールの実行は利用者側で行います。なお、BroadNet の無制限プランのセッションは一度に 1 リクエストまでで、DeepSeek V4.1 Flash 専用です。従量課金のキーでは、同時実行数の上限は同時 4 リクエストです。記事「オープンモデルでのツール呼び出し」に動作するループがあります。
よくある間違い
- 呼び出しごとに異なるメッセージ形式で結果を返す、または 1 つ返し忘れる。
- モデルがまとめて並べたからといって、依存関係のあるツールを同時に実行する。