Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Web-Suche in der API aktivieren

Lektion 4 von 16 Aktualisiert am 2. November 2026 Entwickler
Auf dieser Seite
  1. Geben Sie Grok Echtzeit-Webzugriff
  2. Voraussetzungen: Die Responses-API
  3. Grundlegende Aktivierung
  4. Aktivierung mit dem xAI SDK (Python)
  5. Aktivierung mit dem OpenAI SDK
  6. Aktivierung mit dem Vercel AI SDK
  7. Web-Suche mit anderen Werkzeugen kombinieren
  8. Wichtige Erkenntnisse

Aktualisiert am 2. November 2026. Basierend auf der xAI-Dokumentation: Mit der xai-sdk wird die Web-Suche über die Funktion web_search() aktiviert, die aus xai_sdk.tools importiert wird, in einem Gespräch, das durch client.chat.create erstellt wurde. Das alte Beispiel rief client.tools.web_search() und client.responses.create auf, 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.

Responses
Erforderliche API
5
Filterbare Domains
Auto
Zitate enthalten
$5
/ 1.000 Aufrufe

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"} im tools-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