BroadRouter
始める

tool_choice(ツール選択パラメーター)

更新日

tool_choice とは、ツールの使用を制御するリクエストパラメーターです。OpenAI の Chat Completions では auto(モデルが判断)、required(1 つ以上のツールを必ず呼ぶ)、none(ツールなし)、または強制する関数名を指定します。Anthropic では auto、any、tool、none が対応します。

別名: ツール選択、ツール呼び出しの強制、関数呼び出しの強制、Function Calling 強制、tool choice、tool_choice、forced tool call、forced function call

ツール呼び出しを使うと、モデルはコードに関数の実行を頼めます。tool_choice は、それを任意にするか、必須にするか、オフにするかを決めます。

仕組み

tools(関数名、説明、JSON Schema のパラメーター)を送り、必要に応じて tool_choice も送ります。

OpenAI の値 意味 Anthropic での対応
"auto" モデルがメッセージか 1 つ以上の呼び出しを選ぶ。ツールを送ったときのデフォルト {"type": "auto"}
"required" “The model must call one or more tools”(訳:モデルは 1 つ以上のツールを呼ばなければならない) {"type": "any"}
{"type": "function", "function": {"name": "get_weather"}} その 1 つのツールを強制する {"type": "tool", "name": "get_weather"}
"none" ツールを呼ばない。ツールがないときのデフォルト {"type": "none"}

OpenAI の Function Calling ガイドは、ツールの一覧全体はそのままに、呼び出しをその一部に制限する allowed tools(許可するツール)のオプションも説明しており、プロンプトキャッシュのためにこれを勧めています。

{"model": "broadnet/glm-5.3",
 "messages": [{"role": "user", "content": "Weather in Riyadh?"}],
 "tools": [{"type": "function", "function": {"name": "get_weather",
   "parameters": {"type": "object", "properties": {"city": {"type": "string"}},
                  "required": ["city"]}}}],
 "tool_choice": {"type": "function", "function": {"name": "get_weather"}}}

Anthropic のドキュメントは、any や tool を使うと API が返答をプリフィルするため、モデルは呼び出しの前にテキストを書かないこと、また一部の Claude モデルはツール使用の強制を受け付けず 400 エラーを返すことを注記しています。

なぜ重要か

  • 確実なパイプライン。 呼び出しで終わるべき抽出ステップに、おしゃべりなテキストの返答は要りません。呼び出しを強制すれば、その分岐がなくなります。
  • 安全なターン。 最後のまとめのターンで none にすれば、ツールの一覧はそのままで、モデルが新たなツールのラウンドを始めるのを防げます。
  • キャッシュ。 Anthropic によれば、tool_choice を変えるとキャッシュ済みのメッセージブロックが無効になるので、できるだけターン間で固定してください。

BroadNet Inference の場合

BroadNet の API リファレンスがツール呼び出しをドキュメント化しているのは GLM 5.3 と Qwen3.8 27B だけで、tool_choice の記載はありません。使う予定の値はそれぞれテストしてください。required か関数名を指定して送り、返答に tool_calls が含まれることを確認します。強制がうまく動かない場合は、auto と明確な指示を使って結果を検証するか、同じモデルで構造化出力を使ってください。オープンモデルのツール呼び出しの記事に、検証とリトライのループがあります。

よくある間違い

  • エージェントループのすべてのターンでツールを強制し、最終回答を返せなくしてしまう。
  • required を特定のツールのことだと思い込む。意味は「いずれかのツール」です。

よくある質問

tool_choice のデフォルトは何ですか?

OpenAI の API では、ツールを送らないときは none、ツールがあるときは auto です。Anthropic も同じデフォルトです。

ツール呼び出しを強制すべきなのはどんなときですか?

受け入れられる答えが呼び出しだけのとき、たとえば必ず submit_label を呼ぶ分類器のような場合です。決まった形の JSON で返してほしいだけなら、構造化出力のほうが簡単なことが多いです。

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

BroadNet は GLM 5.3 と Qwen3.8 27B のツール呼び出しをドキュメント化していますが、API リファレンスに tool_choice の記載はありません。頼る前に、使う値をそれぞれテストしてください。

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