Die zwei Kategorien von Grok-Tools
Auf dieser Seite
Das Ökosystem der Grok-API-Tools verstehen
Die Grok-API leistet mehr als nur Textgenerierung. Sie stellt eine Reihe von Tools bereit, die es dem Modell ermöglichen, mit der Außenwelt zu interagieren: die Suche nach Echtzeitinformationen, die Analyse von Daten in sozialen Medien oder die Ausführung von Python-Code. Um diese Fähigkeiten zu nutzen, müssen Sie verstehen, wie sie organisiert sind.
Die Grok-API unterscheidet zwei grundlegende Kategorien von Tools. Diese Unterscheidung bestimmt, wer das Tool ausführt, wo die Verarbeitung stattfindet und was Sie als Entwickler verwalten müssen.
Eingebaute Tools — Serverseitig
Eingebaute Tools laufen direkt auf den Servern von xAI. Wenn das Modell entscheidet, eines dieser Tools zu verwenden, erfolgt die Ausführung automatisch und transparent. Sie müssen keine Infrastruktur verwalten oder Zwischenergebnisse verarbeiten.
Hier sind die fünf verfügbaren eingebauten Tools:
- Web-Suche (
web_search): Echtzeit-Web-Suche mit Bereichsfilterung und automatischen Zitierungen - X-Suche (
x_search): Suche auf X/Twitter mit Filterung nach Konten und Datum - Code-Ausführung (
code_interpreter/code_execution): Ausführung von Python-Code in einer sicheren sandboxierten Umgebung - Sammlungs-Suche (
collections_search/file_search): Suche innerhalb von Dokumenten, die Sie zuvor hochgeladen haben - Remote MCP (
mcp): Verbindung zu externen MCP (Model Context Protocol)-Servern
Um ein eingebautes Tool zu aktivieren, fügen Sie es einfach dem tools-Array in Ihrer Anfrage hinzu:
{
"tools": [{"type": "web_search"}]
}
Funktionsaufruf — Clientseitig
Der Funktionsaufruf funktioniert anders. Sie definieren benutzerdefinierte Funktionen, die das Modell aufrufen kann. Im Gegensatz zu eingebauten Tools führt jedoch Ihr clientseitiger Code die Funktion aus und sendet das Ergebnis zurück an das Modell.
Der Ablauf ist wie folgt:
- Sie beschreiben Ihre Funktionen (Name, Parameter, Beschreibung) in der Anfrage
- Das Modell analysiert die Benutzeranfrage
- Wenn es feststellt, dass eine Funktion benötigt wird, gibt es einen Funktionsaufruf mit Argumenten zurück
- Ihr Code führt die Funktion aus (API-Aufruf, Datenbankabfrage, Berechnung…)
- Sie senden das Ergebnis zurück an das Modell
- Das Modell formuliert seine endgültige Antwort
Dieser Ansatz bietet Ihnen volle Kontrolle: Sie entscheiden, was Ihre Funktionen tun, welche Daten sie verarbeiten und wie sie mit Ihrer Infrastruktur verbunden sind.
Wann Sie jede Kategorie verwenden sollten
Eingebaute Tools sind ideal, wenn Sie Zugriff auf Echtzeitinformationen (Web, soziale Medien) benötigen oder Berechnungen durchführen müssen, ohne Infrastruktur zu verwalten. Der Funktionsaufruf ist vorzuziehen, wenn Sie mit Ihren eigenen Systemen interagieren müssen: interne Datenbanken, Business-APIs oder jeden Dienst, der spezifisch für Ihre Anwendung ist.
Sie können beide Kategorien in einer einzigen Anfrage kombinieren. Zum Beispiel können Sie die Web-Suche aktivieren, während Sie eine benutzerdefinierte Funktion definieren, die die Ergebnisse in Ihre Datenbank speichert.
Kernaussagen
- Die Grok-API bietet zwei Kategorien von Tools: eingebaute Tools (ausgeführt von xAI) und Funktionsaufrufe (ausgeführt von Ihrem Code)
- Eingebaute Tools erfordern keine clientseitige Infrastruktur
- Funktionsaufrufe bieten volle Kontrolle, erfordern aber mehr Entwicklung
- Beide Kategorien können in einer einzigen Anfrage kombiniert werden
- Dieser Kurs konzentriert sich auf die drei wichtigsten eingebauten Tools: Web-Suche, X-Suche und Code-Ausführung