Salt la conținutul principal
Română— Alege o limbă
Meniu

tool_choice și controlul instrumentelor

Lecția 10 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Dirijați modelul către instrumentele potrivite
  2. Moduri de funcționare ale tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Strategii de control
  6. Puncte cheie

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

Scenariutool_choiceparallelmax_turns
Căutare de știrirequiredtrue3
Calcul precis{"type": "function", "name": "calc"}false1
Conversație liberăautotrue5
Răspuns fără instrumentnone--

Puncte cheie

  • tool_choice controlează dacă și ce instrumente utilizează modelul: auto, required, none sau o funcție specifică
  • parallel_tool_calls (implicit true) permite apelarea simultană a instrumentelor
  • max_turns limitează ciclurile instrumentelor server – apelurile client resetează contorul
  • Utilizați required atunci când datele proaspete sunt esențiale
  • Dezactivați paralelismul dacă funcțiile dumneavoastră au dependențe între ele