Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Zoekfunctie op het web inschakelen in de Grok API

Les 1 van 14 Bijgewerkt op 3 november 2026 Beginner
Op deze pagina
  1. Waarom Grok verbinden met het realtime web
  2. De Responses API: het enige ondersteunde eindpunt
  3. De uitvoeringsstroom in vijf stappen
  4. Gebruik met verschillende SDK’s
  5. Praktijkoefening
  6. Belangrijkste punten

Bijgewerkt op 2 november 2026. Gebaseerd op de xAI-documentatie: met de xai-sdk wordt zoeken op het web geactiveerd via de functie web_search() die wordt geïmporteerd uit xai_sdk.tools, binnen een conversatie die is gemaakt met client.chat.create; het oude voorbeeld riep client.tools.web_search() aan, wat niet bestaat in deze SDK. Bron: Web Search.

Bijgewerkt op 3 november 2026. Het eerste voorbeeld riep client.responses.create() aan op de xai-sdk-client, maar deze heeft geen responses-attribuut: met deze SDK verloopt zoeken via client.chat.create(..., tools=[web_search()]), terwijl client.responses.create() behoort tot de openai-SDK die wijst naar https://api.x.ai/v1. Het Vercel AI SDK-voorbeeld gaf tools door als een array en importeerde generateText niet: ze declareren deze in een object, zoals in de xAI-documentatie. Code geverifieerd met xai-sdk 1.21.0 en openai 3.42.1. Bron: Web Search.

Waarom Grok verbinden met het realtime web

Klassieke taalmodellen werken met kennis die bevroren is op hun trainingsdatum. Voor een ontwikkelaar die applicaties bouwt die actuele gegevens vereisen (beurskoersen, nieuws, sportuitslagen, weer), is deze beperking een dealbreaker. De web_search-tool in de Grok API lost dit probleem op door het model in staat te stellen het web in realtime te doorzoeken, direct vanuit uw API-aanroep.

Zoeken op het web met Grok

In tegenstelling tot andere aanbieders die integraties van derden of aparte plugins vereisen, biedt xAI zoeken op het web als een ingebouwde tool aan de serverzijde. U hoeft geen infrastructuur te beheren: het model beslist wanneer er gezocht moet worden, voert de query uit en integreert de resultaten in zijn antwoord.

$5
per 1.000 oproepen
5
filterbare domeinen
0
te beheren infrastructuur
Auto
citaten inbegrepen

De Responses API: het enige ondersteunde eindpunt

Zoeken op het web werkt uitsluitend op de Responses API. Het oude Chat Completions-eindpunt bood een parameter search_parameters, maar deze is inmiddels verouderd. Als u migreert vanaf de oude API, moet u uw aanroepen aanpassen.

Activering gebeurt door de tool web_search toe te voegen aan de array tools in uw verzoek:

import os

from openai import OpenAI

client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")

response = client.responses.create(
    model="grok-4.5",
    input="What is the weather like in Paris today?",
    tools=[{"type": "web_search"}],
)

print(response.output_text)

Dit voorbeeld gebruikt de openai-SDK, die compatibel is met de xAI Responses API; de native xAI SDK, die hieronder wordt gepresenteerd, verloopt via een conversatie.

Dat is alles. Het model analyseert uw prompt, bepaalt of het verse informatie nodig heeft en start de zoekopdracht automatisch. U hoeft geen lus voor aanroepen of conditionele logica te beheren.

De uitvoeringsstroom in vijf stappen

Wanneer u een verzoek verzendt met web_search ingeschakeld, volgt het proces een specifieke volgorde:

  1. Analyse: het model evalueert of de vraag recente gegevens vereist
  2. Beslissing: het kiest ervoor om te zoeken of te antwoorden met zijn interne kennis
  3. Uitvoering: zoeken op het web wordt server-side uitgevoerd (u beheert niets)
  4. Verwerking: resultaten worden geanalyseerd en samengevat
  5. Antwoord: de definitieve tekst wordt gegenereerd met bijbehorende citaten

Dit mechanisme betekent dat het model kan besluiten niet te zoeken als de vraag dit niet rechtvaardigt. Als u bijvoorbeeld vraagt naar de definitie van fotosynthese, zal dit waarschijnlijk geen zoekopdracht op het web activeren.

Gebruik met verschillende SDK’s

De xAI SDK biedt een speciale functie, web_search(), om door te geven aan de lijst met conversatietools:

# Native xAI SDK
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.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))

response = chat.sample()
print(response.content)
print(response.citations)

Met de openai-SDK is het de aanroep vanaf het begin van de les: client.responses.create() met base_url="https://api.x.ai/v1" en tools=[{"type": "web_search"}].

Voor de Vercel AI SDK in JavaScript:

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text, sources } = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: "Latest AI news in Europe",
  tools: {
    web_search: xai.tools.webSearch(),
  },
});

console.log(text);
console.log('Citations:', sources);

Praktijkoefening

Maak een script dat Grok ondervraagt over een actuele gebeurtenis naar keuze. Verifieer dat het antwoord recente informatie bevat (data, gebeurtenissen die plaatsvonden na de cutoff-datum van het model). Probeer vervolgens dezelfde vraag zonder de tool web_search om het verschil te zien.

Belangrijkste punten

  • Zoeken op het web wordt geactiveerd met {"type": "web_search"} in tools (openai-SDK, Responses API) of web_search() in client.chat.create (xai-sdk)
  • Het werkt alleen op de Responses API (niet op Chat Completions)
  • Het model beslist autonoom wanneer het moet zoeken
  • Citaten worden automatisch opgenomen in het antwoord
  • De kosten bedragen $5 per 1.000 tool-aanroepen, plus de verbruikte tokens