tool_choice i kontrola narzędzi
Na tej stronie
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
| Scenariusz | tool_choice | parallel | max_turns |
|---|---|---|---|
| Wyszukiwanie wiadomości | required | true | 3 |
| Precyzyjne obliczenia | {"type": "function", "name": "calc"} | false | 1 |
| Swobodna rozmowa | auto | true | 5 |
| Odpowiedź bez narzędzia | none | - | - |
Kluczowe wnioski
tool_choicekontroluje, czy i które narzędzia model używa:auto,required,nonelub konkretna funkcjaparallel_tool_calls(domyślnietrue) umożliwia jednoczesne wywołania narzędzimax_turnsogranicza 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