Web-Suche in der API aktivieren
Auf dieser Seite
Aktualisiert am 2. November 2026. Basierend auf der xAI-Dokumentation: Mit der
xai-sdkwird die Web-Suche über die Funktionweb_search()aktiviert, die ausxai_sdk.toolsimportiert wird, in einem Gespräch, das durchclient.chat.createerstellt wurde. Das alte Beispiel riefclient.tools.web_search()undclient.responses.createauf, die in diesem SDK nicht existieren. Quelle: Web-Suche.
Geben Sie Grok Echtzeit-Webzugriff
Die Web-Suche ist das am häufigsten genutzte integrierte Werkzeug in der Grok-API. Sie ermöglicht dem Modell, nach aktuellen Informationen im Web zu suchen und überbrückt damit die natürliche Grenze seines Trainingsdatensatzes. Die Aktivierung ist einfach, aber es gibt wichtige Punkte, die beherrscht werden müssen, um sie effektiv einzusetzen.
Voraussetzungen: Die Responses-API
Die Web-Suche ist ausschließlich auf der Responses-API verfügbar. Die alte Chat-Completions-API bot ein „Live Search”-System an, das nun veraltet ist. Wenn Sie weiterhin Chat-Completions für die Web-Suche nutzen, müssen Sie zur Responses-API migrieren.
Die Responses-API verwendet client.responses.create() anstelle von client.chat.completions.create(). Die Struktur der Anfrage und der Antwort unterscheidet sich, sowohl das xAI SDK als auch das OpenAI SDK unterstützen sie jedoch.
Grundlegende Aktivierung
Sie aktivieren die Web-Suche, indem Sie ein Objekt {"type": "web_search"} dem tools-Array in Ihrer Anfrage hinzufügen:
{
"model": "grok-4.20-0309-reasoning",
"input": "Was sind die neuesten Fortschritte in der künstlichen Intelligenz?",
"tools": [
{"type": "web_search"}
]
}
Das ist alles, was Sie für eine grundlegende Web-Suche benötigen. Das Modell bestimmt automatisch, ob eine Suche durchgeführt werden soll, und formuliert die optimale Suchanfrage aus der Benutzeranfrage.
Aktivierung mit dem 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("Was sind die neuesten Fortschritte in der KI?"))
response = chat.sample()
print(response.content)
print(response.citations)
Das SDK stellt die Funktion web_search() bereit, die das Konfigurationsobjekt für das Werkzeug generiert. Sie akzeptiert zudem allowed_domains oder excluded_domains – bis zu fünf Domains, und niemals beide in derselben Anfrage.
Aktivierung mit dem 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="Was sind die neuesten Fortschritte in der KI?",
tools=[{"type": "web_search"}]
)
Das OpenAI SDK funktioniert mit der Grok-API, indem man lediglich die base_url ändert. Die Syntax für das Werkzeug bleibt identisch.
Aktivierung mit dem Vercel AI SDK
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Was sind die neuesten Fortschritte in der KI?",
tools: [xai.tools.webSearch()]
});
Das Vercel AI SDK verwendet xai.tools.webSearch() mit der JavaScript-Konvention für camelCase.
Web-Suche mit anderen Werkzeugen kombinieren
Sie können mehrere Werkzeuge gleichzeitig aktivieren. Das Modell wird das am besten geeignete auswählen oder sie nacheinander verwenden:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
In diesem Beispiel kann das Modell Daten im Web suchen und diese anschließend mit Code-Ausführung analysieren.
Wichtige Erkenntnisse
- Die Web-Suche ist ausschließlich auf der Responses-API verfügbar – Chat-Completions ist für diese Funktion veraltet
- Aktivieren Sie sie mit
{"type": "web_search"}imtools-Array - Das Modell entscheidet automatisch, wann und wie gesucht wird
- Alle SDKs (xAI, OpenAI, Vercel AI) unterstützen die Web-Suche
- Sie können mehrere Werkzeuge in derselben Anfrage gleichzeitig aktivieren