Web-Suche in der Grok-API aktivieren
Auf dieser Seite
Aktualisiert am 2. November 2026. Basierend auf der xAI-Dokumentation: Mit dem
xai-sdkwird die Web-Suche über die Funktionweb_search()aktiviert, die ausxai_sdk.toolsimportiert wird, innerhalb eines Gesprächs, das durchclient.chat.createerstellt wird. Das alte Beispiel riefclient.tools.web_search()auf, was in diesem SDK nicht existiert. Quelle: Web-Suche.
Aktualisiert am 3. November 2026. Das erste Beispiel rief
client.responses.create()auf demxai-sdk-Client auf, der jedoch keinresponses-Attribut besitzt: Mit diesem SDK erfolgt die Suche überclient.chat.create(..., tools=[web_search()]), währendclient.responses.create()zumopenai-SDK gehört, das aufhttps://api.x.ai/v1. zeigt. Das Beispiel des Vercel AI SDK übermittelte Tools als Array und importiertegenerateTextnicht; sie deklarieren dies in einem Objekt, wie in der xAI-Dokumentation beschrieben. Der Code wurde mitxai-sdk1.21.0 undopenai3.42.1 verifiziert. Quelle: Web-Suche.
Warum die Verbindung von Grok zum Echtzeit-Web
Klassische Sprachmodelle arbeiten mit Wissen, das auf ihrem Trainingsdatum eingefroren ist. Für Entwickler, die Anwendungen erstellen, die aktuelle Daten erfordern (Börsenkurse, Nachrichten, Sportergebnisse, Wetter), stellt diese Einschränkung ein absolutes Hindernis dar. Das web_search-Tool in der Grok-API löst dieses Problem, indem es dem Modell ermöglicht, das Web in Echtzeit direkt aus Ihrem API-Aufruf abzufragen.

Im Gegensatz zu anderen Anbietern, die Drittanbieter-Integrationen oder separate Plugins erfordern, bietet xAI die Web-Suche als serverseitiges integriertes Tool an. Sie müssen keine Infrastruktur verwalten: Das Modell entscheidet, wann es suchen soll, führt die Abfrage aus und integriert die Ergebnisse in seine Antwort.
Die Responses API: Der einzige unterstützte Endpunkt
Die Web-Suche funktioniert ausschließlich über die Responses API. Der alte Endpunkt für Chat-Completions bot einen search_parameters-Parameter an, ist jedoch mittlerweile veraltet. Wenn Sie von der alten API migrieren, müssen Sie Ihre Aufrufe anpassen.
Die Aktivierung erfolgt durch Hinzufügen des web_search-Tools zum tools-Array in Ihrer Anfrage:
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="Wie ist das Wetter in Paris heute?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Dieses Beispiel verwendet das openai-SDK, das mit der xAI Responses API kompatibel ist; das native xAI-SDK, das unten vorgestellt wird, läuft über ein Gespräch.
Das ist alles. Das Modell analysiert Ihre Eingabe, bestimmt, ob es frische Informationen benötigt, und löst die Suche automatisch aus. Sie müssen keinen Aufruf-Loop oder bedingte Logik verwalten.
Der fünfstufige Ausführungsablauf
Wenn Sie eine Anfrage mit aktivierter web_search senden, folgt der Prozess einer spezifischen Abfolge:
- Analyse: Das Modell bewertet, ob die Frage aktuelle Daten erfordert.
- Entscheidung: Es entscheidet, ob es sucht oder mit seinem internen Wissen antwortet.
- Ausführung: Die Web-Suche läuft serverseitig (Sie verwalten nichts).
- Verarbeitung: Die Ergebnisse werden analysiert und synthetisiert.
- Antwort: Der finale Text wird mit den zugehörigen Zitaten generiert.
Dieser Mechanismus bedeutet, dass das Modell entscheiden kann, nicht zu suchen, wenn die Frage dies nicht rechtfertigt. Zum Beispiel wird eine Anfrage nach der Definition der Photosynthese wahrscheinlich keine Web-Suche auslösen.
Nutzung mit verschiedenen SDKs
Das xAI-SDK bietet eine dedizierte Funktion web_search(), die in die Liste der Gesprächstools übergeben wird:
# 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("Aktuellste KI-Nachrichten in Europa"))
response = chat.sample()
print(response.content)
print(response.citations)
Mit dem openai-SDK erfolgt es wie am Anfang dieser Lektion: client.responses.create() mit base_url="https://api.x.ai/v1" und tools=[{"type": "web_search"}].
Für das 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: "Aktuellste KI-Nachrichten in Europa",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Zitate:', sources);
Praktische Übung
Erstellen Sie ein Skript, das Grok eine aktuelle Veranstaltung Ihrer Wahl abfragt. Verifizieren Sie, dass die Antwort aktuelle Informationen enthält (Daten, Ereignisse, die nach dem Cutoff-Datum des Modells aufgetreten sind). Versuchen Sie dann dieselbe Frage ohne das web_search-Tool, um den Unterschied zu erkennen.
Kernaussagen
- Die Web-Suche wird aktiviert durch
{"type": "web_search"}intools(openai-SDK, Responses API) oderweb_search()inclient.chat.create(xai-sdk) - Sie funktioniert nur über die Responses API (nicht über Chat Completions)
- Das Modell entscheidet autonom, wann es suchen muss
- Zitate werden automatisch in die Antwort aufgenommen
- Die Kosten betragen $5 pro 1.000 Tool-Aufrufe plus verbrauchte Tokens