Webzoekopdrachten inschakelen in de API
Op deze pagina
Bijgewerkt op 2 november 2026. Gebaseerd op de xAI-documentatie: met de
xai-sdkwordt webzoeken ingeschakeld via de functieweb_search()die wordt geïmporteerd uitxai_sdk.tools, binnen een conversatie aangemaakt doorclient.chat.create; het oude voorbeeld riepclient.tools.web_search()enclient.responses.createaan, welke niet bestaan in deze SDK. Bron: Web Search.
Geef Grok toegang tot het web in realtime
Web Search is de meest gebruikte geïntegreerde tool in de Grok API. Het stelt het model in staat om actuele informatie op het web te zoeken, waardoor de natuurlijke beperking van de trainingsdata wordt overbrugd. Activering is eenvoudig, maar er zijn belangrijke punten om onder de knie te krijgen voor effectief gebruik.
Vereisten: de Responses API
Web Search is uitsluitend beschikbaar op de Responses API. De oude Chat Completions API bood een “Live Search”-systeem dat inmiddels verouderd is. Als u Chat Completions nog steeds gebruikt voor webzoeken, moet u migreren naar de Responses API.
De Responses API gebruikt client.responses.create() in plaats van client.chat.completions.create(). De structuur van het verzoek en het antwoord verschilt, maar zowel de xAI SDK als de OpenAI SDK ondersteunen beide.
Basisactivering
U schakelt Web Search in door een {"type": "web_search"}-object toe te voegen aan de tools-array in uw verzoek:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Dat is alles wat u nodig heeft voor basis webzoeken. Het model bepaalt automatisch of er een zoekopdracht moet worden uitgevoerd en formuleert de optimale zoekvraag op basis van het gebruikersbericht.
Activering met de xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
De SDK biedt de functie web_search(), die het configuratieobject voor de tool genereert. Deze accepteert ook allowed_domains of excluded_domains—maximaal vijf domeinen, en nooit beide in hetzelfde verzoek.
Activering met de OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
De OpenAI SDK werkt met de Grok API door simpelweg de base_url te wijzigen. De syntaxis voor de tool blijft identiek.
Activering met de Vercel AI SDK
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "What are the latest advancements in AI?",
tools: [xai.tools.webSearch()]
});
De Vercel AI SDK gebruikt xai.tools.webSearch() volgens de JavaScript camelCase-conventie.
Webzoekopdrachten combineren met andere tools
U kunt meerdere tools tegelijkertijd inschakelen. Het model kiest de meest geschikte tool, of gebruikt ze sequentieel:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
In dit voorbeeld kan het model gegevens op het web zoeken en deze vervolgens analyseren met Code Execution.
Belangrijkste punten
- Web Search is uitsluitend beschikbaar op de Responses API—Chat Completions is verouderd voor deze functie
- Schakel het in met
{"type": "web_search"}in detools-array - Het model bepaalt automatisch wanneer en hoe er gezocht wordt
- Alle SDK’s (xAI, OpenAI, Vercel AI) ondersteunen Web Search
- U kunt meerdere tools tegelijkertijd inschakelen in hetzelfde verzoek