Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Web-Suche in der Grok-API aktivieren

Lektion 1 von 14 Aktualisiert am 3. November 2026 Anfänger
Auf dieser Seite
  1. Warum die Verbindung von Grok zum Echtzeit-Web
  2. Die Responses API: Der einzige unterstützte Endpunkt
  3. Der fünfstufige Ausführungsablauf
  4. Nutzung mit verschiedenen SDKs
  5. Praktische Übung
  6. Kernaussagen

Aktualisiert am 2. November 2026. Basierend auf der xAI-Dokumentation: Mit dem xai-sdk wird die Web-Suche über die Funktion web_search() aktiviert, die aus xai_sdk.tools importiert wird, innerhalb eines Gesprächs, das durch client.chat.create erstellt wird. Das alte Beispiel rief client.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 dem xai-sdk-Client auf, der jedoch kein responses-Attribut besitzt: Mit diesem SDK erfolgt die Suche über client.chat.create(..., tools=[web_search()]), während client.responses.create() zum openai-SDK gehört, das auf https://api.x.ai/v1. zeigt. Das Beispiel des Vercel AI SDK übermittelte Tools als Array und importierte generateText nicht; sie deklarieren dies in einem Objekt, wie in der xAI-Dokumentation beschrieben. Der Code wurde mit xai-sdk 1.21.0 und openai 3.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.

Web-Suche mit Grok

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.

$5
pro 1.000 Aufrufe
5
filterbare Domänen
0
zu verwaltende Infrastruktur
Auto
Zitate enthalten

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:

  1. Analyse: Das Modell bewertet, ob die Frage aktuelle Daten erfordert.
  2. Entscheidung: Es entscheidet, ob es sucht oder mit seinem internen Wissen antwortet.
  3. Ausführung: Die Web-Suche läuft serverseitig (Sie verwalten nichts).
  4. Verarbeitung: Die Ergebnisse werden analysiert und synthetisiert.
  5. 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"} in tools (openai-SDK, Responses API) oder web_search() in client.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