Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

tool_choice a řízení nástrojů

Lekce 10 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Nasměruj model ke správným nástrojům
  2. Režimy tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Strategie řízení
  6. Klíčové poznatky

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_choiceparallelmax_turns
Hledání zprávrequiredtrue3
Přesný výpočet{"type": "function", "name": "calc"}false1
Volná konverzaceautotrue5
Odpověď bez nástrojenone--

Klíčové poznatky

  • tool_choice řídí, zda a které nástroje model použije: auto, required, none nebo konkrétní funkce
  • parallel_tool_calls (výchozí true) umožňuje simultánní volání nástrojů
  • max_turns omezuje 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é