tool_choice und Werkzeugsteuerung
Auf dieser Seite
Das Modell in die richtige Richtung lenken
Standardmäßig entscheidet das Modell frei darüber, welche Werkzeuge es verwendet (oder ob es überhaupt welche nutzt). Der Parameter tool_choice gibt Ihnen eine feinere Kontrolle über dieses Verhalten.
tool_choice-Modi
auto (Standard)
Das Modell entscheidet frei. Es kann ein Werkzeug, mehrere Werkzeuge oder keines verwenden:
{
"model": "grok-4.20-0309-reasoning",
"input": "Was ist die Hauptstadt von Frankreich?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Bei dieser einfachen faktischen Frage wird das Modell wahrscheinlich ohne Websuche antworten. Bei einer Frage zu aktuellen Ereignissen wird es eine Suche starten.
required
Zwingt das Modell, mindestens ein Werkzeug zu verwenden:
{
"model": "grok-4.20-0309-reasoning",
"input": "Geben Sie mir die heutigen Börsenkurse.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Nützlich, wenn Sie wissen, dass die Antwort frische Daten erfordert und das Modell nicht aus dem Gedächtnis antworten soll.
none
Verhindert die Werkzeugnutzung, auch wenn Werkzeuge deklariert sind:
{
"model": "grok-4.20-0309-reasoning",
"input": "Erklären Sie das Konzept der Rekursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktisch, um eine rein textbasierte Antwort in einem Kontext zu erzwingen, in dem Werkzeuge normalerweise verfügbar sind.
Spezifische Funktion
Zwingt die Verwendung einer spezifischen Funktion:
{
"model": "grok-4.20-0309-reasoning",
"input": "Paris",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Ruft das Wetter ab",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"tool_choice": {"type": "function", "name": "get_weather"}
}
Das Modell ist darauf beschränkt, get_weather mit den entsprechenden Argumenten aufzurufen.
parallel_tool_calls
Standardmäßig ist parallel_tool_calls auf true gesetzt. Das Modell kann mehrere Werkzeuge parallel innerhalb eines einzigen Durchgangs starten:
{
"model": "grok-4.20-0309-reasoning",
"input": "Vergleichen Sie das Wetter in Paris und London.",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Ruft das Wetter für eine Stadt ab",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"parallel_tool_calls": true
}
Das Modell könnte get_weather("Paris") und get_weather("London") gleichzeitig aufrufen, was die Verarbeitung beschleunigt.
Um dieses Verhalten zu deaktivieren:
{
"parallel_tool_calls": false
}
Deaktivieren Sie parallele Aufrufe, wenn Ihre Funktionen Seiteneffekte haben oder voneinander abhängig sind (beispielsweise, wenn die zweite Funktion vom Ergebnis der ersten abhängt).
max_turns
Der Parameter max_turns begrenzt die Anzahl der Interaktionsdurchgänge zwischen dem Modell und den Werkzeugen auf Serverseite:
{
"model": "grok-4.20-0309-reasoning",
"input": "Führen Sie eine eingehende Analyse des KI-Marktes im Jahr 2026 durch.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"max_turns": 5
}
Ein „Durchgang” entspricht einem vollständigen Zyklus: Das Modell ruft ein Werkzeug auf, erhält das Ergebnis und entscheidet dann, ob es einen weiteren Aufruf benötigt. Mit max_turns: 5 kann das Modell bis zu 5 serverseitige Werkzeugaufrufszyklen durchführen, bevor es seine endgültige Antwort erstellt.
Verhalten bei Client-Werkzeugen
max_turns gilt nur für Server-Werkzeuge. Wenn das Modell eine Client-Funktion aufruft, wird der Zähler bei der nächsten Anfrage zurückgesetzt. Dies bedeutet, dass jeder Client-Server-Rundgang eine neue Zuteilung von Durchgängen erzeugt.
Steuerstrategien
| Szenario | tool_choice | parallel | max_turns |
|---|---|---|---|
| Nachrichtensuche | required | true | 3 |
| Präzise Berechnung | {"type": "function", "name": "calc"} | false | 1 |
| Freies Gespräch | auto | true | 5 |
| Antwort ohne Werkzeug | none | - | - |
Kernaussagen
tool_choicesteuert, ob und welche Werkzeuge das Modell verwendet:auto,required,noneoder eine spezifische Funktionparallel_tool_calls(Standardtrue) ermöglicht parallele Werkzeugaufrufemax_turnsbegrenzt serverseitige Werkzeugzyklen – Client-Aufrufe setzen den Zähler zurück- Verwenden Sie
required, wenn frische Daten essenziell sind - Deaktivieren Sie Parallelität, wenn Ihre Funktionen voneinander abhängig sind