tool_choice și controlul instrumentelor
Pe această pagină
Dirijați modelul către instrumentele potrivite
În mod implicit, modelul decide liber ce instrumente să utilizeze (sau dacă să folosească vreunul). Parametrul tool_choice vă oferă un control mai fin asupra acestui comportament.
Moduri de funcționare ale tool_choice
auto (implicit)
Modelul decide liber. Poate utiliza un singur instrument, mai multe sau niciunul:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Pentru această întrebare factuală simplă, modelul va răspunde probabil fără o căutare pe web. Pentru o întrebare despre evenimente curente, acesta va lansa o căutare.
required
Forțează modelul să utilizeze cel puțin un instrument:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Util atunci când știți că răspunsul necesită date proaspete, iar modelul nu ar trebui să răspundă din memorie.
none
Interzice utilizarea instrumentelor, chiar dacă acestea sunt declarate:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Practic pentru a forța un răspuns pur textual într-un context în care instrumentele sunt disponibile în mod normal.
Funcție specifică
Forțează utilizarea unei funcții specifice:
{
"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"}
}
Modelul este constrâns să apeleze get_weather cu argumentele corespunzătoare.
parallel_tool_calls
În mod implicit, parallel_tool_calls este setat la true. Modelul poate lansa mai multe instrumente în paralel într-o singură iterație:
{
"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
}
Modelul ar putea apela simultan get_weather("Paris") și get_weather("Londres"), ceea ce accelerează procesarea.
Pentru a dezactiva acest comportament:
{
"parallel_tool_calls": false
}
Dezactivați apelurile paralele dacă funcțiile dumneavoastră au efecte secundare sau dependențe între ele (de exemplu, dacă a doua funcție depinde de rezultatul primei).
max_turns
Parametrul max_turns limitează numărul de cicluri de interacțiune dintre model și instrumente lato parte a serverului:
{
"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
}
Un „ciclu“ (turn) corespunde unei bucle complete: modelul apelează un instrument, primește rezultatul, apoi decide dacă are nevoie de un alt apel. Cu max_turns: 5, modelul poate efectua până la 5 cicluri de apelare a instrumentelor lato parte a serverului înainte de a produce răspunsul final.
Comportament cu instrumentele client
max_turns se aplică doar instrumentelor server. Când modelul apelează o funcție client, contorul se resetează la următoarea cerere. Aceasta înseamnă că fiecare dus-întors client-server creează o nouă alocare de cicluri.
Strategii de control
| Scenariu | tool_choice | parallel | max_turns |
|---|---|---|---|
| Căutare de știri | required | true | 3 |
| Calcul precis | {"type": "function", "name": "calc"} | false | 1 |
| Conversație liberă | auto | true | 5 |
| Răspuns fără instrument | none | - | - |
Puncte cheie
tool_choicecontrolează dacă și ce instrumente utilizează modelul:auto,required,nonesau o funcție specificăparallel_tool_calls(implicittrue) permite apelarea simultană a instrumentelormax_turnslimitează ciclurile instrumentelor server – apelurile client resetează contorul- Utilizați
requiredatunci când datele proaspete sunt esențiale - Dezactivați paralelismul dacă funcțiile dumneavoastră au dependențe între ele