Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

tool_choice en toolbeheer

Les 10 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Stuur het model naar de juiste tools
  2. tool_choice-modi
  3. parallel_tool_calls
  4. max_turns
  5. Controlestrategieën
  6. Belangrijkste punten

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

Scenariotool_choiceparallelmax_turns
Nieuwszoekopdrachtrequiredtrue3
Precieze berekening{"type": "function", "name": "calc"}false1
Vrij gesprekautotrue5
Antwoord zonder toolnone--

Belangrijkste punten

  • tool_choice bepaalt of en welke tools het model gebruikt: auto, required, none of een specifieke functie
  • parallel_tool_calls (standaard true) maakt gelijktijdige tool-aanroepen mogelijk
  • max_turns beperkt servertool-cycli; clientaanroepen resetten de teller
  • Gebruik required wanneer verse gegevens essentieel zijn
  • Schakel parallelisme uit als uw functies onderling afhankelijk zijn