tool_choice u l-Kontroll tal-Għodod
F'din il-paġna
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
| Xenarju | tool_choice | parallel | max_turns |
|---|---|---|---|
| Tiftix tal-aħbarijiet | required | true | 3 |
| Kalkolu preċiż | {"type": "function", "name": "calc"} | false | 1 |
| Konversazzjoni libera | auto | true | 5 |
| Tweġiba mingħajr għodda | none | - | - |
Punti Ewlenin
tool_choicejikkontrolla jekk u liema għodod juża l-mudell:auto,required,none, jew funzjoni speċifikaparallel_tool_calls(awtomatikutrue) jippermetti sejħiet simultanji tal-għododmax_turnsjillimita ċ-ċikli tal-għodod tas-server—is-sejħiet tal-klijent jirriżettjaw il-kontatur- Uża
requiredmeta data friska tkun essenzjali - Iddiżattiva l-parallelizmu jekk il-funzjonijiet tiegħek ikollhom dipendenzi fuq xulxin