tool_choice og styring af værktøjer
På denne side
Styr modellen mod de rigtige værktøjer
Som standard beslutter modellen frit, hvilke værktøjer den skal bruge (eller om den overhovedet skal bruge nogen). Parameteren tool_choice giver dig finere kontrol over denne adfærd.
tool_choice-tilstande
auto (standard)
Modellen beslutter frit. Den kan bruge ét værktøj, flere eller ingen:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Ved dette simple faktaspørgsmål vil modellen sandsynligvis svare uden websøgning. Ved spørgsmål om aktuelle begivenheder vil den starte en søgning.
required
Tvinger modellen til at bruge mindst ét værktøj:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Nyttigt, når du ved, at svaret kræver friske data, og modellen ikke skal svare ud fra hukommelsen.
none
Forbyder brug af værktøjer, selvom de er defineret:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktisk til at gennemtvinge et rent tekstsvar i en kontekst, hvor værktøjer normalt er tilgængelige.
Specifik funktion
Tvinger brugen af 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 er begrænset til at kalde get_weather med de passende argumenter.
parallel_tool_calls
Som standard er parallel_tool_calls sat til true. Modellen kan starte flere værktøjer parallelt inden for én omgang:
{
"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 kalde get_weather("Paris") og get_weather("Londres") samtidigt, hvilket fremskynder behandlingen.
Sådan deaktiverer du denne adfærd:
{
"parallel_tool_calls": false
}
Deaktiver parallelle kald, hvis dine funktioner har bivirkninger eller afhænger af hinanden (f.eks. hvis den anden funktion afhænger af resultatet fra den første).
max_turns
Parameteren max_turns begrænser antallet af interaktionsomgange mellem modellen og værktøjerne på serversiden:
{
"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 „omgang” svarer til en komplet cyklus: modellen kalder et værktøj, modtager resultatet og beslutter derefter, om den har brug for endnu et kald. Med max_turns: 5 kan modellen udføre op til 5 værktøjskald-cyklusser på serveren, før den producerer sit endelige svar.
Adfærd med klientværktøjer
max_turns gælder kun for serverværktøjer. Når modellen kalder en klientfunktion, nulstilles tælleren ved næste anmodning. Det betyder, at hver rundtur mellem klient og server skaber en ny tildeling af omgange.
Kontrolstrategier
| Scenario | tool_choice | parallel | max_turns |
|---|---|---|---|
| Nyhedssøgning | required | true | 3 |
| Præcis beregning | {"type": "function", "name": "calc"} | false | 1 |
| Fri samtale | auto | true | 5 |
| Svar uden værktøj | none | - | - |
Vigtige pointer
tool_choicestyrer, om og hvilke værktøjer modellen bruger:auto,required,noneeller en specifik funktionparallel_tool_calls(standardtrue) muliggør samtidige værktøjskaldmax_turnsbegrænser cyklusser for serverværktøjer – klientkald nulstiller tælleren- Brug
required, når friske data er afgørende - Deaktiver parallelisme, hvis dine funktioner afhænger af hinanden