Przejdź do głównej treści
Polski— Wybierz język
Menu

tool_choice i kontrola narzędzi

Lekcja 10 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Kieruj modelem ku odpowiednim narzędziom
  2. Tryby tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Strategie kontroli
  6. Kluczowe wnioski

Kieruj modelem ku odpowiednim narzędziom

Domyślnie model samodzielnie decyduje, których narzędzi użyć (lub czy w ogóle z jakiegoś skorzystać). Parametr tool_choice daje Ci precyzyjniejszą kontrolę nad tym zachowaniem.

Tryby tool_choice

auto (domyślny)

Model podejmuje decyzję swobodnie. Może użyć jednego narzędzia, kilku lub żadnego:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?",
  "tools": [{"type": "web_search"}],
  "tool_choice": "auto"
}

W przypadku tego prostego pytania faktograficznego model prawdopodobnie odpowie bez wyszukiwania w sieci. Przy pytaniu o bieżące wydarzenia uruchomi wyszukiwarkę.

required

Wymusza na modelu użycie co najmniej jednego narzędzia:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Give me today's stock market prices.",
  "tools": [{"type": "web_search"}],
  "tool_choice": "required"
}

Przydatne, gdy wiesz, że odpowiedź wymaga świeżych danych, a model nie powinien odpowiadać z pamięci.

none

Zabrania używania narzędzi, nawet jeśli zostały zadeklarowane:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain the concept of recursion.",
  "tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
  "tool_choice": "none"
}

Praktyczne rozwiązanie, gdy chcesz wymusić czysto tekstową odpowiedź w kontekście, gdzie narzędzia są normalnie dostępne.

Konkretne wywołanie funkcji

Wymusza użycie konkretnej funkcji:

{
  "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 jest ograniczony do wywołania get_weather z odpowiednimi argumentami.

parallel_tool_calls

Domyślnie parallel_tool_calls ma wartość true. Model może uruchomić wiele narzędzi równolegle w ramach jednego cyklu:

{
  "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 może jednocześnie wywołać get_weather("Paris") i get_weather("Londres"), co przyspiesza przetwarzanie.

Aby wyłączyć to zachowanie:

{
  "parallel_tool_calls": false
}

Wyłącz wywołania równoległe, jeśli Twoje funkcje mają skutki uboczne lub zależą od siebie nawzajem (na przykład, jeśli druga funkcja zależy od wyniku pierwszej).

max_turns

Parametr max_turns ogranicza liczbę cykli interakcji między modelem a narzędziami po stronie serwera:

{
  "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
}

„Cykl“ (turn) odpowiada pełnemu procesowi: model wywołuje narzędzie, otrzymuje wynik, a następnie decyduje, czy potrzebuje kolejnego wywołania. Przy max_turns: 5 model może wykonać do 5 cykli wywołań narzędzi po stronie serwera przed wygenerowaniem ostatecznej odpowiedzi.

Zachowanie w przypadku narzędzi klienckich

max_turns dotyczy wyłącznie narzędzi serwerowych. Gdy model wywołuje funkcję kliencką, licznik resetuje się przy następnym żądaniu. Oznacza to, że każda wymiana danych klient-serwer tworzy nowy przydział cykli.

Strategie kontroli

Scenariusztool_choiceparallelmax_turns
Wyszukiwanie wiadomościrequiredtrue3
Precyzyjne obliczenia{"type": "function", "name": "calc"}false1
Swobodna rozmowaautotrue5
Odpowiedź bez narzędzianone--

Kluczowe wnioski

  • tool_choice kontroluje, czy i które narzędzia model używa: auto, required, none lub konkretna funkcja
  • parallel_tool_calls (domyślnie true) umożliwia jednoczesne wywołania narzędzi
  • max_turns ogranicza cykle narzędzi serwerowych – wywołania klienckie resetują licznik
  • Używaj required, gdy świeże dane są niezbędne
  • Wyłącz równoległość, jeśli Twoje funkcje są od siebie zależne