Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Server- en clienttools combineren

Les 8 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Twee categorieën tools op hetzelfde platform
  2. Beide combineren in één verzoek
  3. De hybride flow
  4. Praktijkvoorbeelden
  5. Facturatie voor servertools
  6. Belangrijkste punten

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:

  1. web_search gebruiken om informatie te vinden (automatische uitvoering aan serverzijde)
  2. save_to_database aanroepen 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_call aan 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