Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Ingebouwde tools voor de Responses API

Les 9 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Mogelijkheden toevoegen aan het model
  2. De vier soorten tools
  3. Meerdere tools combineren
  4. Server-side versus client-side tools
  5. Belangrijkste punten

Mogelijkheden toevoegen aan het model

Grok-modellen zijn niet beperkt tot tekstgeneratie. Met de parameter tools geeft u ze toegang tot hulpmiddelen die hun mogelijkheden aanzienlijk uitbreiden: realtime webzoekopdrachten, zoeken op X (voorheen Twitter), uitvoeren van Python-code en uw eigen aangepaste functies.

web_search
Realtime webzoekopdracht
x_search
Zoeken op X
code
Python-interpreter
function
Aangepaste functies

De vier soorten tools

Hiermee kan het model realtime informatie op het web zoeken:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Het model beslist automatisch wanneer het een zoekopdracht uitvoert. De resultaten worden met bronvermeldingen in het antwoord verwerkt.

Zoekt naar berichten op X (voorheen Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Bijzonder nuttig om publieke opinie, trends en realtime reacties vast te leggen.

code_interpreter

Voert Python-code server-side uit voor berekeningen, data-analyse of het maken van grafieken:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Het model schrijft Python-code, voert deze uit op de servers van xAI en verwerkt de resultaten in zijn antwoord.

function

Uw eigen functies die het model kan aanroepen. Het model genereert de argumenten, maar uw code voert de functie uit:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Meerdere tools combineren

U kunt maximaal 128 tools in één verzoek opnemen. Het model kiest de tool (of tools) die het beste passen:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

In dit voorbeeld kan het model eerst web_search gebruiken om de uitslagen te vinden en vervolgens code_interpreter om ze in een tabel weer te geven.

Server-side versus client-side tools

Het onderscheid is fundamenteel:

  • Server-side tools (web_search, x_search, code_interpreter): Worden automatisch uitgevoerd door de servers van xAI. U hoeft niets te doen; het model start de zoekopdracht of code, haalt het resultaat op en verwerkt dit in zijn antwoord.

  • Client-side tools (function): Het model genereert een functieaanroep met argumenten en pauzeert vervolgens de generatie. Uw code voert de functie uit en u stuurt het resultaat terug in een nieuw verzoek.

Dit verschil heeft directe gevolgen voor de architectuur van uw applicatie, zoals u in de volgende lessen zult zien.

Belangrijkste punten

  • Vier soorten tools: web_search, x_search, code_interpreter, function
  • De eerste drie draaien server-side; u heeft geen eigen infrastructuur nodig
  • function-tools draaien client-side; uw code regelt de uitvoering
  • U kunt tot 128 tools per verzoek combineren
  • Het model beslist automatisch wanneer en welke tools het gebruikt