Ingebouwde tools voor de Responses API
Op deze pagina
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.
De vier soorten tools
web_search
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.
x_search
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