tool_choice a řízení nástrojů
Na této stránce
Nasměruj model ke správným nástrojům
Ve výchozím nastavení se model sám rozhoduje, které nástroje použije (nebo zda nepoužije žádný). Parametr tool_choice ti dává přesnější kontrolu nad tímto chováním.
Režimy tool_choice
auto (výchozí)
Model se rozhoduje svobodně. Může použít jeden nástroj, několik, nebo žádný:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
U této jednoduché faktické otázky model pravděpodobně odpoví bez vyhledávání na webu. U otázek týkajících se aktuálního dění spustí vyhledávání.
required
Vynutí použití alespoň jednoho nástroje:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Užitečné, když víš, že odpověď vyžaduje čerstvá data a model by neměl odpovídat z paměti.
none
Zakazuje použití nástrojů, i když jsou deklarované:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Praktické pro vynucení čistě textové odpovědi v kontextu, kde jsou nástroje běžně dostupné.
Konkrétní funkce
Vynutí použití konkrétní funkce:
{
"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 nucen zavolat get_weather s příslušnými argumenty.
parallel_tool_calls
Ve výchozím nastavení je parallel_tool_calls nastaveno na true. Model může v rámci jednoho kroku spustit více nástrojů paralelně:
{
"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 současně zavolat get_weather("Paris") a get_weather("Londres"), což urychlí zpracování.
Pro vypnutí tohoto chování:
{
"parallel_tool_calls": false
}
Paralelní volání vypni, pokud mají tvé funkce vedlejší účinky nebo jsou na sobě závislé (například pokud druhá funkce závisí na výsledku první).
max_turns
Parametr max_turns omezuje počet interakčních cyklů mezi modelem a nástroji na straně serveru:
{
"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
}
„Cyklus“ (turn) odpovídá úplnému průběhu: model zavolá nástroj, obdrží výsledek a poté se rozhodne, zda potřebuje další volání. Při max_turns: 5 může model provést až 5 cyklů volání nástrojů na straně serveru, než vytvoří svou konečnou odpověď.
Chování u klientských nástrojů
max_turns platí pouze pro serverové nástroje. Když model zavolá klientskou funkci, čítač se při dalším požadavku resetuje. To znamená, že každá cesta tam a zpět mezi klientem a serverem vytváří novou alokaci cyklů.
Strategie řízení
| Scénář | tool_choice | parallel | max_turns |
|---|---|---|---|
| Hledání zpráv | required | true | 3 |
| Přesný výpočet | {"type": "function", "name": "calc"} | false | 1 |
| Volná konverzace | auto | true | 5 |
| Odpověď bez nástroje | none | - | - |
Klíčové poznatky
tool_choiceřídí, zda a které nástroje model použije:auto,required,nonenebo konkrétní funkceparallel_tool_calls(výchozítrue) umožňuje simultánní volání nástrojůmax_turnsomezuje cykly serverových nástrojů – volání klienta čítač resetuje- Použij
required, když jsou zásadní čerstvá data - Vypni paralelismus, pokud jsou tvé funkce na sobě závislé