De twee categorieën Grok-tools
Op deze pagina
Inzicht in het ecosysteem van Grok API-tools
De Grok API doet meer dan alleen tekst genereren. Het biedt een reeks tools waarmee het model interactie kan aangaan met de buitenwereld: zoeken naar realtime-informatie, analyseren van gegevens op sociale media of het uitvoeren van Python-code. Om deze mogelijkheden optimaal te benutten, moet u begrijpen hoe ze zijn georganiseerd.
De Grok API maakt onderscheid tussen twee fundamentele categorieën tools. Dit onderscheid bepaalt wie de tool uitvoert, waar de verwerking plaatsvindt en wat u als ontwikkelaar moet beheren.
Ingebouwde tools — Serverzijde
Ingebouwde tools draaien direct op de servers van xAI. Wanneer het model besluit een van deze tools te gebruiken, verloopt de uitvoering automatisch en transparant. U hoeft geen infrastructuur te beheren of tussenresultaten te verwerken.
Dit zijn de vijf beschikbare ingebouwde tools:
- Web Search (
web_search): Realtime zoekopdrachten op het web, met domeinfiltering en automatische citaten - X Search (
x_search): Zoeken op X/Twitter, met filtering op account en datum - Code Execution (
code_interpreter/code_execution): Uitvoeren van Python-code in een beveiligde, geïsoleerde omgeving (sandbox) - Collections Search (
collections_search/file_search): Zoeken in documenten die u eerder hebt geüpload - Remote MCP (
mcp): Verbinden met externe MCP-servers (Model Context Protocol)
Om een ingebouwde tool in te schakelen, voegt u deze eenvoudig toe aan de tools-array in uw verzoek:
{
"tools": [{"type": "web_search"}]
}
Function Calling — Clientzijde
Function Calling werkt anders. U definieert aangepaste functies die het model kan aanroepen. In tegenstelling tot ingebouwde tools, voert uw code aan de clientzijde de functie uit en stuurt u het resultaat terug naar het model.
De workflow ziet er als volgt uit:
- U beschrijft uw functies (naam, parameters, beschrijving) in het verzoek
- Het model analyseert het verzoek van de gebruiker
- Als het model bepaalt dat een functie nodig is, retourneert het een functieaanroep met argumenten
- Uw code voert de functie uit (API-call, databasequery, berekening, etc.)
- U stuurt het resultaat terug naar het model
- Het model formuleert het definitieve antwoord
Deze aanpak geeft u volledige controle: u bepaalt wat uw functies doen, welke gegevens ze verwerken en hoe ze verbinding maken met uw infrastructuur.
Wanneer gebruikt u welke categorie?
Ingebouwde tools zijn ideaal wanneer u toegang nodig hebt tot realtime-informatie (web, sociale media) of berekeningen moet uitvoeren zonder infrastructuur te beheren. Function Calling heeft de voorkeur wanneer u interactie nodig hebt met uw eigen systemen: interne databases, zakelijke API’s of elke service die specifiek is voor uw applicatie.
U kunt beide categorieën combineren in één verzoek. U kunt bijvoorbeeld Web Search inschakelen en tegelijkertijd een aangepaste functie definiëren die de resultaten in uw database opslaat.
Belangrijkste punten
- De Grok API biedt twee categorieën tools: ingebouwde tools (uitgevoerd door xAI) en Function Calling (uitgevoerd door uw code)
- Voor ingebouwde tools is geen infrastructuur aan de clientzijde vereist
- Function Calling biedt volledige controle, maar vereist meer ontwikkelwerk
- Beide categorieën kunnen in één verzoek worden gecombineerd
- Deze cursus richt zich op de drie belangrijkste ingebouwde tools: Web Search, X Search en Code Execution