tool_choice u l-kontroll
F'din il-paġna
Ikkontrolla l-imġiba tal-mudell
B’mod predefinit, il-mudell jiddeċiedi waħdu jekk isejjaħx għodda jew jirrispondix direttament. Dan huwa l-mod auto. Madankollu, f’xi każijiet, ikollok bżonn kontroll aktar fin. Il-parametru tool_choice jagħtik dik is-setgħa.
L-erba’ modi ta’ tool_choice
Il-mod auto (predefinit)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="auto"
)
Il-mudell jevalwa t-talba u jiddeċiedi:
- Jekk it-talba teħtieġ data esterna → jsejjaħ għodda
- Jekk jista’ jirrispondi direttament → jirrispondi mingħajr għodda
Dan huwa l-aktar mod komuni u naturali. Użah meta tifda l-ġudizzju tal-mudell.
Il-mod required
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="required"
)
Il-mudell irid isejjaħ mill-inqas għodda waħda. Ma jistax jirrispondi direttament, anke jekk diġà jaf it-tweġiba. Każijiet ta’ użu:
- Estrazzjoni strutturata: Trid tifforza lill-mudell biex jipproċessa d-data f’format speċifiku permezz ta’ għodda ddedikata
- Validazzjoni obbligatorja: Kull talba trid tgħaddi minn għodda ta’ verifika
- Reġistrazzjoni sistematika: Kollox irid jiġi rreġistrat permezz ta’ għodda ta’ logging
Il-mod none
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="none"
)
Jiddiżattiva kompletament is-sejħa tal-funzjonijiet għal din it-talba. Il-mudell jara d-definizzjonijiet tal-għodod (jibqgħu fil-kuntest) iżda ma jistax isejħilhom. Każijiet ta’ użu:
- Fażi ta’ ċċarar: Trid li l-mudell jistaqsi mistoqsijiet qabel ma jaġixxi
- Mod ta’ previżjoni: Uri x’ikun se jagħmel il-mudell mingħajr ma tesegwixxi l-azzjoni
- Ripjieg: Jekk l-għodod ikunu temporanjament mhux disponibbli
Mod speċifiku (ifforza għodda partikolari)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={
"type": "function",
"function": {"name": "get_weather"}
}
)
Il-mudell huwa mġiegħel isejjaħ eżattament din l-għodda. Ma jistax jagħżel oħra, u lanqas ma jista’ jirrispondi direttament. Dan huwa l-aktar mod restrittiv. Każijiet ta’ użu:
- Fluss ta’ xogħol sekwenzjali: F’dan il-pass, din l-għodda speċifika trid tiġi msejħa
- Testijiet: Trid tivverifika li l-mudell jiġġenera l-argumenti korretti għal għodda mogħtija
- Estrazzjoni mmirata: Taf liema għodda trid tuża u trid biss li l-mudell jipproċessa l-parametri
Tqabbil tal-modi
| Mod | Imġiba | Meta tużah |
|---|---|---|
| auto | Il-mudell jiddeċiedi liberament | Każ ġenerali, chatbots |
| required | Irid isejjaħ mill-inqas għodda waħda | Estrazzjoni, validazzjoni |
| none | L-ebda għodda mhix permessa | Ċċarar, ripjieg |
| {"function":...} | Jifforza għodda speċifika | Fluss ta' xogħol, testijiet |
Strateġiji avvanzati
Alternanza tal-modi f’fluss ta’ xogħol
Fluss ta’ xogħol intelliġenti jista’ jbiddel il-tool_choice skont il-pass:
# Pass 1: ifforza t-tfittxija
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={"type": "function", "function": {"name": "search_products"}}
)
# Pass 2: ħalli lill-mudell jiddeċiedi (analiżi jew mistoqsija)
response2 = client.chat.completions.create(
model="grok-4.5",
messages=updated_messages,
tools=tools,
tool_choice="auto"
)
Ikkombina mal-prompt tas-sistema
Il-prompt tas-sistema jista’ jiggwida lill-mudell fil-għażliet tal-għodod tiegħu anke fil-mod auto:
messages = [
{
"role": "system",
"content": "Int assistent tal-ivvjaġġar. Dejjem uża "
"get_weather qabel ma tirrakkomanda attivitajiet barra."
},
{"role": "user", "content": "X'għandi nagħmel f'Marsilja dan il-weekend?"}
]
Punti Ewlenin
auto: Il-mudell jiddeċiedi (predefinit, rakkomandat għall-biċċa l-kbira tal-każijiet)required: Jifforza s-sejħa ta’ mill-inqas għodda waħdanone: Jiddiżattiva temporanjament is-sejħa tal-funzjonijiet- Mod speċifiku: Jifforza s-sejħa ta’ għodda speċifika bl-isem
- Ibdel il-modi f’fluss ta’ xogħol għal kontroll fin
- Ikkombina
tool_choicemal-prompt tas-sistema biex tiggwida lill-mudell