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

tool_choice u l-kontroll

Lezzjoni 5 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ikkontrolla l-imġiba tal-mudell
  2. L-erba’ modi ta’ tool_choice
  3. Tqabbil tal-modi
  4. Strateġiji avvanzati
  5. Punti Ewlenin

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ħda
  • none: 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_choice mal-prompt tas-sistema biex tiggwida lill-mudell