Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Kombination von Server- und Client-Tools

Lektion 12 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Hybrid-Arbeitsabläufe
  2. Kombination von Server-Tools und Funktionen
  3. Der Hybrid-Ausführungsfluss
  4. Häufige Kombinationsmuster
  5. max_turns und Hybrid-Tools
  6. Mehrstufiger Kontext mit Speicher
  7. Kernaussagen

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:

  1. Das Modell löst web_search automatisch (serverseitig) aus, um die Ergebnisse zu finden.
  2. Das Modell integriert die Daten in eine Zusammenfassung.
  3. 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_turns begrenzt 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_turns wird nach jedem Client-Rundengang zurückgesetzt.
  • Häufige Muster: Suche + Aktion, Berechnung + Benachrichtigung, Aggregation aus mehreren Quellen.
  • Verwenden Sie store: true und previous_response_id für mehrstufige Arbeitsabläufe.