Server- en clienttools combineren
Op deze pagina
Twee categorieën tools op hetzelfde platform
De Grok API maakt onderscheid tussen twee fundamenteel verschillende soorten tools, gebaseerd op de uitvoering. Het begrijpen van dit onderscheid is essentieel voor het ontwerpen van robuuste architecturen.
Ingebouwde tools (serverzijde)
xAI voert deze tools automatisch uit op hun servers. U hoeft niets te beheren: geen lokale uitvoering, geen resultaten doorsturen. Het model roept ze aan en ontvangt de resultaten direct.
| Tool | Identificatie | Beschrijving |
|---|---|---|
| Web Search | web_search | Zoeken op het web in realtime |
| X Search | x_search | Zoeken op X/Twitter |
| Code Interpreter | code_interpreter | Uitvoeren van Python in een sandbox |
| Collections Search | collections_search | Zoeken in uw geüploade documenten |
| Remote MCP | mcp | Verbinding met externe MCP-servers |
Aangepaste functies (clientzijde)
Dit zijn uw eigen functies, gedefinieerd via function calling. Het model retourneert een tool_call, uw code voert de functie uit en u stuurt het resultaat terug. Dit is het mechanisme dat u in eerdere lessen heeft geleerd.
Beide combineren in één verzoek
De kracht van de Grok API ligt in de mogelijkheid om server- en clienttools te mixen in één enkel verzoek:
tools = [
# Server tool — automatisch uitgevoerd door xAI
{"type": "web_search"},
# Client tool — uitgevoerd door uw code
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Informatie opslaan in de database",
"parameters": {
"type": "object",
"properties": {
"key": {"type": "string"},
"value": {"type": "string"}
},
"required": ["key", "value"]
}
}
}
]
Wanneer het model dit verzoek ontvangt, kan het:
web_searchgebruiken om informatie te vinden (automatische uitvoering aan serverzijde)save_to_databaseaanroepen om het resultaat op te slaan (keert terug naar de client)
De hybride flow
Het gedrag verschilt per type tool:
- Servertool: het model roept de tool aan, xAI voert deze uit, het resultaat wordt automatisch geïntegreerd en het model gaat verder
- Clienttool: het model retourneert de
tool_callaan de client, de uitvoering stopt en hervat wanneer u het resultaat terugstuurt
Wanneer het model beide typen in hetzelfde verzoek gebruikt, worden servertools eerst uitgevoerd (zonder uw tussenkomst). Als het model vervolgens ook een clienttool nodig heeft, retourneert het de tool_call aan u, waarbij de resultaten van de servertools al in de context zijn opgenomen.
Praktijkvoorbeelden
Webzoeken + bedrijfslogica
# Gebruiker vraagt: "Vind de Bitcoin-prijs en sla deze op"
# Het model:
# 1. Roept web_search aan om de prijs te vinden (serverzijde, automatisch)
# 2. Roept save_price(symbol="BTC", price=68432) aan (clientzijde)
X-zoeken + melding
# "Waarschuw me voor tweets over ons product sinds gisteren"
# Het model:
# 1. Roept x_search aan om tweets te vinden (serverzijde)
# 2. Roept send_notification(count=12, summary="...") aan (clientzijde)
Code Interpreter + opslag
# "Bereken het gemiddelde van deze gegevens en sla het resultaat op"
# Het model:
# 1. Roept code_interpreter aan voor de berekening (serverzijde)
# 2. Roept save_result(key="avg", value="42.5") aan (clientzijde)
Facturatie voor servertools
Ingebouwde tools worden op twee manieren gefactureerd:
- Tokens: standaardverbruik (input + output)
- Aanroepen: vaste kosten per tool-aanroep
Het model kan meerdere servertools aanroepen voor één enkel verzoek; de kosten tellen op. Houd hier rekening mee wanneer u web_search inschakelt: het model kan meerdere zoekopdrachten uitvoeren om de resultaten te verfijnen.
Belangrijkste punten
- Twee tooltypes: server (automatisch) en client (function calling)
- Servertools (
web_search,x_search,code_interpreter) worden uitgevoerd zonder uw tussenkomst - U kunt beide typen combineren in één verzoek
- Servertools worden eerst uitgevoerd, daarna kan het model uw functies aanroepen
- Elke aanroep van een servertool wordt gefactureerd (tokens + kosten per aanroep)
- Bronvermeldingen worden automatisch gegenereerd voor gegevens afkomstig van servertools