On this page
1 · When / when not
Start with the decision.
The page opens with the operational choice. Candidates do not need a lecture before they can use the reference.
Default
Use auto for open-ended agentic loops. Use any when the first step must be a tool call.
2 · Rule table
Selection table
| Mode | Use when | Avoid when |
|---|---|---|
| auto | Model may answer or call a tool. | A tool call is mandatory. |
| any | At least one tool must be called. | The user might only need text. |
| forced | Exactly one tool is correct. | The model must select between tools. |
3 · Pitfalls
Common mistakes

Oh — that was the trap.Two patterns to avoid.
Forcing too earlyBlocks the model from answering simple clarifying questions.
Auto in mandatory lookupLets the model skip a required source of truth.
4 · FAQ
FAQ
What should I use by default?
Use auto unless the architecture requires a tool call.
Is forced common?
No. It is for constrained pipelines with one correct tool.