Spring til hovedindhold
Dansk— Vælg et sprog
Menu

tool_choice og styring af værktøjer

Lektion 10 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Styr modellen mod de rigtige værktøjer
  2. tool_choice-tilstande
  3. parallel_tool_calls
  4. max_turns
  5. Kontrolstrategier
  6. Vigtige pointer

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

Scenariotool_choiceparallelmax_turns
Nyhedssøgningrequiredtrue3
Præcis beregning{"type": "function", "name": "calc"}false1
Fri samtaleautotrue5
Svar uden værktøjnone--

Vigtige pointer

  • tool_choice styrer, om og hvilke værktøjer modellen bruger: auto, required, none eller en specifik funktion
  • parallel_tool_calls (standard true) muliggør samtidige værktøjskald
  • max_turns begræ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