Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De twee categorieën Grok-tools

Les 1 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Inzicht in het ecosysteem van Grok API-tools
  2. Ingebouwde tools — Serverzijde
  3. Function Calling — Clientzijde
  4. Wanneer gebruikt u welke categorie?
  5. Belangrijkste punten

Inzicht in het ecosysteem van Grok API-tools

Overzicht van tools in de documentatie 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.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

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:

  1. U beschrijft uw functies (naam, parameters, beschrijving) in het verzoek
  2. Het model analyseert het verzoek van de gebruiker
  3. Als het model bepaalt dat een functie nodig is, retourneert het een functieaanroep met argumenten
  4. Uw code voert de functie uit (API-call, databasequery, berekening, etc.)
  5. U stuurt het resultaat terug naar het model
  6. 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