Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Eingebaute Werkzeuge für die Responses API

Lektion 9 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Funktionen für das Modell erweitern
  2. Die vier Werkzeugtypen
  3. Kombination mehrerer Werkzeuge
  4. Serverseitige vs. Clientseitige Werkzeuge
  5. Kernaussagen

Funktionen für das Modell erweitern

Grok-Modelle beschränken sich nicht auf die Textgenerierung. Mit dem tools-Parameter können Sie ihnen Zugriff auf Werkzeuge verschaffen, die ihre Fähigkeiten erheblich erweitern: Echtzeit-Web-Suche, Suche auf X (ehemals Twitter), Ausführung von Python-Code und Ihre eigenen benutzerdefinierten Funktionen.

web_search
Echtzeit-Web-Suche
x_search
Suche auf X
code
Python-Interpreter
function
Benutzerdefinierte Funktionen

Die vier Werkzeugtypen

Ermöglicht dem Modell, Informationen im Web in Echtzeit zu suchen:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Was ist die neueste Nachricht über KI in Europa?",
  "tools": [{"type": "web_search"}]
}

Das Modell entscheidet automatisch, wann eine Suche durchgeführt werden soll. Die Ergebnisse werden in seine Antwort integriert, versehen mit Verweisen.

Sucht nach Beiträgen auf X (ehemals Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Was sagt die Tech-Community über das neueste iPhone?",
  "tools": [{"type": "x_search"}]
}

Besonders nützlich, um die öffentliche Meinung, Trends und Reaktionen in Echtzeit zu erfassen.

code_interpreter

Führt Python-Code serverseitig zur Berechnung, Datenanalyse oder Erstellung von Diagrammen aus:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Berechnen Sie den Mittelwert und die Standardabweichung dieser Werte: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Das Modell schreibt Python-Code, führt ihn auf den xAI-Servern aus und integriert die Ergebnisse in seine Antwort.

function

Ihre eigenen Funktionen, die das Modell aufrufen kann. Das Modell generiert die Argumente, aber Ihr Code führt die Funktion aus:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Wie ist das Wetter in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Ruft das Wetter für eine gegebene Stadt ab",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "Stadtname"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Kombination mehrerer Werkzeuge

Sie können bis zu 128 Werkzeuge in einer einzigen Anfrage übergeben. Das Modell wählt dasjenige (oder diejenigen) aus, die passen:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Suchen Sie die neuesten Ergebnisse der Ligue 1 und erstellen Sie eine Ergebnisliste.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

In diesem Beispiel könnte das Modell zunächst web_search verwenden, um die Ergebnisse zu finden, und anschließend code_interpreter, um diese in eine Tabelle zu formatieren.

Serverseitige vs. Clientseitige Werkzeuge

Der Unterschied ist grundlegend:

  • Serverseitige Werkzeuge (web_search, x_search, code_interpreter): Werden automatisch von den xAI-Servern ausgeführt. Sie müssen nichts tun – das Modell startet die Suche oder den Code, holt das Ergebnis und integriert es in seine Antwort.

  • Clientseitige Werkzeuge (function): Das Modell generiert einen Funktionsaufruf mit Argumenten und unterbricht dann die Generierung. Ihr Code führt die Funktion aus, und Sie senden das Ergebnis in einer neuen Anfrage zurück.

Dieser Unterschied wirkt sich direkt auf Ihre Anwendungsarchitektur aus, wie Sie in den folgenden Lektionen sehen werden.

Kernaussagen

  • Vier Werkzeugtypen: web_search, x_search, code_interpreter, function
  • Die ersten drei laufen serverseitig – es ist keine Infrastruktur von Ihrer Seite erforderlich
  • function-Werkzeuge laufen clientseitig – Ihr Code übernimmt die Ausführung
  • Sie können bis zu 128 Werkzeuge pro Anfrage kombinieren
  • Das Modell entscheidet automatisch, wann und welche Werkzeuge es verwendet