Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

tool_choice u l-Kontroll tal-Għodod

Lezzjoni 10 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Iddireġi l-mudell lejn l-għodod it-tajba
  2. Modalitajiet ta’ tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Strateġiji ta’ kontroll
  6. Punti Ewlenin

Iddireġi l-mudell lejn l-għodod it-tajba

B’mod awtomatiku, il-mudell jiddeċiedi liberament liema għodod juża (jew jekk jużax xi waħda). Il-parametru tool_choice jagħtik kontroll aktar fin fuq dan l-imġiba.

Modalitajiet ta’ tool_choice

auto (awtomatiku)

Il-mudell jiddeċiedi liberament. Jista’ juża għodda waħda, diversi, jew l-ebda waħda:

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

Għal din il-mistoqsija fattwali sempliċi, x’aktarx il-mudell iwieġeb mingħajr ma jsir tiftix fuq il-web. Għal mistoqsija dwar avvenimenti kurrenti, se jniedi tiftix.

required (meħtieġ)

Jfurza lill-mudell juża mill-inqas għodda waħda:

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

Utili meta tkun taf li t-tweġiba teħtieġ data friska u l-mudell m’għandux iwieġeb mill-memorja tiegħu.

none (l-ebda)

Jipprojbixxi l-użu tal-għodod, anke jekk ikunu ddikjarati:

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

Prattiku biex tiforza tweġiba purament testwali f’kuntest fejn l-għodod normalment ikunu disponibbli.

Funzjoni speċifika

Tfurza l-użu ta’ funzjoni speċifika:

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

Il-mudell huwa mġiegħel isejjaħ get_weather bl-argumenti xierqa.

parallel_tool_calls

B’mod awtomatiku, parallel_tool_calls huwa ssettjat għal true. Il-mudell jista’ jniedi għodod multipli b’mod parallel fi ħdan dawra waħda:

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

Il-mudell jista’ jsejjaħ get_weather("Paris") u get_weather("Londres") simultanjament, li jħaffef l-ipproċessar.

Biex tiddiżattiva dan l-imġiba:

{
  "parallel_tool_calls": false
}

Iddiżattiva s-sejħiet paralleli jekk il-funzjonijiet tiegħek għandhom effetti sekondarji jew jiddependu fuq xulxin (pereżempju, jekk it-tieni funzjoni tiddependi fuq ir-riżultat tal-ewwel waħda).

max_turns

Il-parametru max_turns jillimita n-numru ta’ dawriet ta’ interazzjoni bejn il-mudell u l-għodod fuq in-naħa tas-server:

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

“Dawra” tikkorrispondi għal ċiklu sħiħ: il-mudell isejjaħ għodda, jirċievi r-riżultat, imbagħad jiddeċiedi jekk għandux bżonn sejħa oħra. B’max_turns: 5, il-mudell jista’ jwettaq sa 5 ċikli ta’ sejħiet tal-għodod fuq is-server qabel ma jipproduċi t-tweġiba finali tiegħu.

Imġiba ma’ għodod tal-klijent

max_turns japplika biss għall-għodod tas-server. Meta l-mudell isejjaħ funzjoni tal-klijent, il-kontatur jiġi rriżettjat fit-talba li jmiss. Dan ifisser li kull vjaġġ ta’ mar u ġej bejn il-klijent u s-server joħloq allokazzjoni ġdida ta’ dawriet.

Strateġiji ta’ kontroll

Xenarjutool_choiceparallelmax_turns
Tiftix tal-aħbarijietrequiredtrue3
Kalkolu preċiż{"type": "function", "name": "calc"}false1
Konversazzjoni liberaautotrue5
Tweġiba mingħajr għoddanone--

Punti Ewlenin

  • tool_choice jikkontrolla jekk u liema għodod juża l-mudell: auto, required, none, jew funzjoni speċifika
  • parallel_tool_calls (awtomatiku true) jippermetti sejħiet simultanji tal-għodod
  • max_turns jillimita ċ-ċikli tal-għodod tas-server—is-sejħiet tal-klijent jirriżettjaw il-kontatur
  • Uża required meta data friska tkun essenzjali
  • Iddiżattiva l-parallelizmu jekk il-funzjonijiet tiegħek ikollhom dipendenzi fuq xulxin