tool_choice a ovládanie nástrojov
Na tejto strane
Nasmeruj model k správnym nástrojom
Model sa štandardne sám rozhoduje, ktoré nástroje použije (alebo či nepoužije žiadny). Parameter tool_choice ti dáva presnejšiu kontrolu nad týmto správaním.
Režimy tool_choice
auto (predvolené)
Model sa rozhoduje voľne. Môže použiť jeden nástroj, viacero, alebo žiadny:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Pri tejto jednoduchej faktickej otázke model pravdepodobne odpovie bez vyhľadávania na webe. Pri otázke týkajúcej sa aktuálneho diania spustí vyhľadávanie.
required
Prinúti model použiť aspoň jeden nástroj:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Užitočné, keď vieš, že odpoveď vyžaduje čerstvé dáta a model by nemal odpovedať z pamäte.
none
Zakazuje použitie nástrojov, aj keď sú deklarované:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktické pre vynútenie čisto textovej odpovede v kontexte, kde sú nástroje bežne dostupné.
Konkrétna funkcia
Vynúti použitie konkrétnej funkcie:
{
"model": "grok-4.20-0309-reasoning",
"input": "Paris",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"tool_choice": {"type": "function", "name": "get_weather"}
}
Model je obmedzený na volanie get_weather s príslušnými argumentmi.
parallel_tool_calls
Parameter parallel_tool_calls je štandardne nastavený na true. Model môže v rámci jedného kroku spustiť viacero nástrojov paralelne:
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the weather in Paris and London.",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}],
"parallel_tool_calls": true
}
Model môže súčasne zavolať get_weather("Paris") a get_weather("Londres"), čo urýchli spracovanie.
Ak chceš toto správanie vypnúť:
{
"parallel_tool_calls": false
}
Paralelné volania vypni, ak majú tvoje funkcie vedľajšie účinky alebo sú na sebe závislé (napríklad, ak druhá funkcia závisí od výsledku prvej).
max_turns
Parameter max_turns obmedzuje počet interakčných kôl medzi modelom a nástrojmi na strane servera:
{
"model": "grok-4.20-0309-reasoning",
"input": "Perform an in-depth analysis of the AI market in 2026.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"max_turns": 5
}
„Kolo“ zodpovedá úplnému cyklu: model zavolá nástroj, dostane výsledok a potom sa rozhodne, či potrebuje ďalšie volanie. Pri nastavení max_turns: 5 môže model vykonať až 5 cyklov volania nástrojov na strane servera pred tým, než vygeneruje konečnú odpoveď.
Správanie pri klientskych nástrojoch
max_turns sa vzťahuje len na serverové nástroje. Keď model zavolá klientsku funkciu, čítač sa pri ďalšej požiadavke resetuje. To znamená, že každá výmena medzi klientom a serverom vytvára novú alokáciu kôl.
Stratégie riadenia
| Scenár | tool_choice | parallel | max_turns |
|---|---|---|---|
| Hľadanie správ | required | true | 3 |
| Presný výpočet | {"type": "function", "name": "calc"} | false | 1 |
| Voľná konverzácia | auto | true | 5 |
| Odpoveď bez nástroja | none | - | - |
Kľúčové poznatky
tool_choiceriadi, či a ktoré nástroje model použije:auto,required,nonealebo konkrétna funkciaparallel_tool_calls(predvolenétrue) umožňuje simultánne volania nástrojovmax_turnsobmedzuje cykly serverových nástrojov – klientske volania resetujú čítač- Použi
required, keď sú nevyhnutné čerstvé dáta - Vypni paralelizmus, ak sú tvoje funkcie na sebe závislé