ツール呼び出しを使うと、モデルはコードに関数の実行を頼めます。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を特定のツールのことだと思い込む。意味は「いずれかのツール」です。