Eingebaute Werkzeuge für die Responses API
Auf dieser Seite
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.
Die vier Werkzeugtypen
web_search
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.
x_search
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