Kombination von Server- und Client-Tools
Auf dieser Seite
Hybrid-Arbeitsabläufe
Die wahre Stärke der Responses API entfaltet sich, wenn Sie Server-Tools (die automatisch von xAI ausgeführt werden) und Client-Tools (Ihre benutzerdefinierten Funktionen) in einer einzigen Anfrage kombinieren. Das Modell orchestriert diese Tools autonom und erstellt komplexe Arbeitsabläufe in nur wenigen Zeilen Code.
Kombination von Server-Tools und Funktionen
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Suchen Sie die neuesten Ligue 1-Fußballergebnisse und senden Sie eine Zusammenfassung an mein Team.",
tools=[
{"type": "web_search"},
{
"type": "function",
"name": "send_team_message",
"description": "Sendet eine Nachricht an das Team über Slack",
"parameters": {
"type": "object",
"properties": {
"channel": {"type": "string"},
"message": {"type": "string"}
},
"required": ["channel", "message"]
}
}
]
)
In diesem Szenario:
- Das Modell löst
web_searchautomatisch (serverseitig) aus, um die Ergebnisse zu finden. - Das Modell integriert die Daten in eine Zusammenfassung.
- Das Modell ruft
send_team_message(clientseitig) auf, sodass Ihr Code die Slack-Nachricht sendet.
Der Hybrid-Ausführungsfluss
Der Ablauf unterscheidet sich je nach Tool-Typ:
Nur Server-Tools
Anfrage → [Modell → web_search → Ergebnis → Modell] → Endantwort
Alles findet auf der xAI-Seite statt. Sie erhalten die Endantwort direkt mit den integrierten Ergebnissen.
Nur Client-Tools
Anfrage → [Modell → function_call] → PAUSE
Ihr Code führt die Funktion aus
Ergebnis → [Modell] → Endantwort
Das Modell pausiert, Ihr Code führt die Funktion aus, und Sie senden das Ergebnis zurück.
Hybrid-Flow
Anfrage → [Modell → web_search → Ergebnis → Modell → function_call] → PAUSE
Ihr Code führt die Funktion aus
Ergebnis → [Modell] → Endantwort
Das Modell nutzt zuerst Server-Tools (automatisch) und ruft dann Ihre Funktion auf, wenn es Ihre Infrastruktur benötigt.
Häufige Kombinationsmuster
Suche + Aktion
Kombinieren Sie web_search oder x_search mit einer Aktionsfunktion:
tools = [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "function",
"name": "create_report",
"description": "Erstellt einen Bericht im CRM",
"parameters": {
"type": "object",
"properties": {
"title": {"type": "string"},
"content": {"type": "string"},
"tags": {"type": "array", "items": {"type": "string"}}
},
"required": ["title", "content"]
}
}
]
Berechnung + Benachrichtigung
Kombinieren Sie code_interpreter mit einer Benachrichtigungsfunktion:
tools = [
{"type": "code_interpreter"},
{
"type": "function",
"name": "send_alert",
"description": "Sendet eine Warnung, wenn ein Schwellenwert überschritten wird",
"parameters": {
"type": "object",
"properties": {
"metric": {"type": "string"},
"value": {"type": "number"},
"threshold": {"type": "number"}
},
"required": ["metric", "value"]
}
}
]
max_turns und Hybrid-Tools
Das Verhalten von max_turns ist in einem hybriden Kontext wichtig:
max_turnsbegrenzt die serverseitigen Runden innerhalb einer einzigen Anfrage.- Wenn das Modell eine Client-Funktion aufruft und Ihr Code das Ergebnis zurückgibt, beginnt eine neue Zuteilung von
max_turns.
In der Praxis bedeutet dies, dass Client-Aufrufe Ihren Server-Rundenhaushalt nicht erschöpfen. Das Modell kann beispielsweise drei Websuchen durchführen, Ihre Funktion aufrufen und dann nach Erhalt des Ergebnisses weitere drei Suchen durchführen.
Mehrstufiger Kontext mit Speicher
Für komplexe Arbeitsabläufe, die mehrere Interaktionen überspannen, kombinieren Sie Speicher und Verkettung:
# Runde 1: initiale Suche
r1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analysieren Sie Markttrends für KI.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
store=True,
max_turns=5
)
# Runde 2: Vertiefung mit internen Daten
r2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Vergleichen Sie dies mit unseren internen Daten.",
tools=[{
"type": "function",
"name": "query_internal_db",
"description": "Abfrage der internen Datenbank",
"parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
}],
previous_response_id=r1.id,
store=True
)
Kernaussagen
- Kombinieren Sie Server-Tools und Client-Funktionen in einer einzigen Anfrage für hybride Arbeitsabläufe.
- Server-Tools werden automatisch ausgeführt; Client-Funktionen unterbrechen die Generierung.
max_turnswird nach jedem Client-Rundengang zurückgesetzt.- Häufige Muster: Suche + Aktion, Berechnung + Benachrichtigung, Aggregation aus mehreren Quellen.
- Verwenden Sie
store: trueundprevious_response_idfür mehrstufige Arbeitsabläufe.