BroadRouter
始める

並列ツール呼び出し(parallel tool calls)

更新日

並列ツール呼び出しとは、モデルが 1 回の応答で複数のツール呼び出し(たとえば 3 つのファイル読み込み)を返すことです。OpenAI 形式では tool_calls 内の複数のエントリとして届き、parallel_tool_calls を false にするとモデルは 1 ターンに 0 個か 1 個しか呼び出しません。

別名: 並列ツール呼び出し、並列関数呼び出し、並列 Function Calling、複数のツール呼び出し、parallel_tool_calls、parallel tool calls、parallel tool calling、parallel function calling、multiple tool calls

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 つ返し忘れる。
  • モデルがまとめて並べたからといって、依存関係のあるツールを同時に実行する。

よくある質問

並列ツール呼び出しは並列の API リクエストのことですか?

いいえ。モデルが 1 回の応答で複数の呼び出しを返します。それを同時に実行するか 1 つずつ実行するかはコード次第で、次のリクエストですべての結果をまとめて返します。

並列ツール呼び出しを無効にするには?

OpenAI 形式では parallel_tool_calls を false にします。OpenAI によると、これは "ensures exactly zero or one tool is called"(ツールの呼び出しをちょうど 0 個か 1 個にする)とのことです。Anthropic の API では、tool_choice の中で disable_parallel_tool_use を true にします。

BroadNet Inference は parallel_tool_calls に対応していますか?

BroadNet の API リファレンスには parallel_tool_calls の記載がありません。ツール呼び出しは GLM 5.3 と Qwen3.8 27B について記載されています。複数の呼び出しが返るか、このフラグが守られるかをテストしてください。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く