Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

tool_choice a ovládanie nástrojov

Lekcia 10 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Nasmeruj model k správnym nástrojom
  2. Režimy tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Stratégie riadenia
  6. Kľúčové poznatky

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ártool_choiceparallelmax_turns
Hľadanie správrequiredtrue3
Presný výpočet{"type": "function", "name": "calc"}false1
Voľná konverzáciaautotrue5
Odpoveď bez nástrojanone--

Kľúčové poznatky

  • tool_choice riadi, či a ktoré nástroje model použije: auto, required, none alebo konkrétna funkcia
  • parallel_tool_calls (predvolené true) umožňuje simultánne volania nástrojov
  • max_turns obmedzuje 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é