tool_choice en toolbeheer
Op deze pagina
Stuur het model naar de juiste tools
Standaard beslist het model vrij welke tools het gebruikt (of het überhaupt tools gebruikt). De parameter tool_choice geeft u fijnere controle over dit gedrag.
tool_choice-modi
auto (standaard)
Het model beslist vrij. Het kan één tool, meerdere tools of geen enkele tool gebruiken:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Bij deze eenvoudige feitelijke vraag zal het model waarschijnlijk antwoorden zonder een webzoekopdracht. Bij een vraag over actuele gebeurtenissen start het een zoekopdracht.
required
Dwingt het model om minstens één tool te gebruiken:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Handig wanneer u weet dat het antwoord verse gegevens vereist en het model niet uit het geheugen mag antwoorden.
none
Verbiedt het gebruik van tools, zelfs als tools zijn gedeclareerd:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktisch om een puur tekstueel antwoord af te dwingen in een context waarin tools normaal gesproken beschikbaar zijn.
Specifieke functie
Dwingt het gebruik van een specifieke functie af:
{
"model": "grok-4.20-0309-reasoning",
"input": "Paris",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"tool_choice": {"type": "function", "name": "get_weather"}
}
Het model is beperkt tot het aanroepen van get_weather met de juiste argumenten.
parallel_tool_calls
Standaard staat parallel_tool_calls op true. Het model kan meerdere tools parallel lanceren binnen één beurt:
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the weather in Paris and London.",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"parallel_tool_calls": true
}
Het model kan tegelijkertijd get_weather("Paris") en get_weather("Londres") aanroepen, wat de verwerking versnelt.
Om dit gedrag uit te schakelen:
{
"parallel_tool_calls": false
}
Schakel parallelle aanroepen uit als uw functies neveneffecten hebben of van elkaar afhankelijk zijn (bijvoorbeeld als de tweede functie afhankelijk is van het resultaat van de eerste).
max_turns
De parameter max_turns beperkt het aantal interactiebeurten tussen het model en de tools aan de serverzijde:
{
"model": "grok-4.20-0309-reasoning",
"input": "Perform an in-depth analysis of the AI market in 2026.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"max_turns": 5
}
Een “beurt” komt overeen met een volledige cyclus: het model roept een tool aan, ontvangt het resultaat en beslist vervolgens of het nog een aanroep nodig heeft. Met max_turns: 5 kan het model maximaal 5 tool-aanroepcycli aan de serverzijde uitvoeren voordat het zijn definitieve antwoord produceert.
Gedrag met clienttools
max_turns is alleen van toepassing op servertools. Wanneer het model een clientfunctie aanroept, wordt de teller gereset bij het volgende verzoek. Dit betekent dat elke roundtrip tussen client en server een nieuwe toewijzing van beurten creëert.
Controlestrategieën
| Scenario | tool_choice | parallel | max_turns |
|---|---|---|---|
| Nieuwszoekopdracht | required | true | 3 |
| Precieze berekening | {"type": "function", "name": "calc"} | false | 1 |
| Vrij gesprek | auto | true | 5 |
| Antwoord zonder tool | none | - | - |
Belangrijkste punten
tool_choicebepaalt of en welke tools het model gebruikt:auto,required,noneof een specifieke functieparallel_tool_calls(standaardtrue) maakt gelijktijdige tool-aanroepen mogelijkmax_turnsbeperkt servertool-cycli; clientaanroepen resetten de teller- Gebruik
requiredwanneer verse gegevens essentieel zijn - Schakel parallelisme uit als uw functies onderling afhankelijk zijn