tool_choice och styrning av verktyg
På denna sida
Styr modellen mot rätt verktyg
Som standard bestämmer modellen fritt vilka verktyg den ska använda (eller om den ska använda några alls). Parametern tool_choice ger dig finare kontroll över detta beteende.
Lägen för tool_choice
auto (standard)
Modellen bestämmer fritt. Den kan använda ett verktyg, flera eller inga:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
För denna enkla faktfråga kommer modellen sannolikt att svara utan en webbsökning. För en fråga om aktuella händelser kommer den att starta en sökning.
required
Tvingar modellen att använda minst ett verktyg:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Användbart när du vet att svaret kräver färska data och att modellen inte bör svara från minnet.
none
Förbjuder användning av verktyg, även om verktyg är deklarerade:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktiskt för att tvinga fram ett rent textsvar i en kontext där verktyg normalt är tillgängliga.
Specifik funktion
Tvingar användningen av en specifik funktion:
{
"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"}
}
Modellen begränsas till att anropa get_weather med lämpliga argument.
parallel_tool_calls
Som standard är parallel_tool_calls inställt på true. Modellen kan starta flera verktyg parallellt inom en enda tur:
{
"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
}
Modellen kan anropa get_weather("Paris") och get_weather("Londres") samtidigt, vilket påskyndar bearbetningen.
För att inaktivera detta beteende:
{
"parallel_tool_calls": false
}
Inaktivera parallella anrop om dina funktioner har sidoeffekter eller beroenden av varandra (till exempel om den andra funktionen beror på resultatet från den första).
max_turns
Parametern max_turns begränsar antalet interaktionsturer mellan modellen och verktygen på serversidan:
{
"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
}
En “tur” motsvarar en fullständig cykel: modellen anropar ett verktyg, tar emot resultatet och avgör sedan om den behöver göra ett nytt anrop. Med max_turns: 5 kan modellen utföra upp till 5 cykler för verktygsanrop på serversidan innan den producerar sitt slutgiltiga svar.
Beteende med klientverktyg
max_turns gäller endast för serververktyg. När modellen anropar en klientfunktion nollställs räknaren vid nästa begäran. Detta innebär att varje tur mellan klient och server skapar en ny tilldelning av turer.
Kontrollstrategier
| Scenario | tool_choice | parallel | max_turns |
|---|---|---|---|
| Nyhetssökning | required | true | 3 |
| Exakt beräkning | {"type": "function", "name": "calc"} | false | 1 |
| Fri konversation | auto | true | 5 |
| Svar utan verktyg | none | - | - |
Viktiga punkter
tool_choicestyr om och vilka verktyg modellen använder:auto,required,noneeller en specifik funktionparallel_tool_calls(standardtrue) möjliggör samtidiga verktygsanropmax_turnsbegränsar cykler för serververktyg – klientanrop nollställer räknaren- Använd
requirednär färska data är avgörande - Inaktivera parallellism om dina funktioner har beroenden av varandra