tool_choice agus rialú
Ar an leathanach seo
Rialú ar iompar an mhóidín
De réir réamhshocraithe, cinneann an móideán leis féin an nglaofaidh sé ar uirlis nó an bhfreagróidh sé go díreach. Is é auto an mód seo. Ach i gcásanna áirithe, teastaíonn rialú níos mine uait. Tugann an paraiméadar tool_choice an chumhacht sin duit.
Na ceithre mhód tool_choice
Mód auto (réamhshocraithe)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="auto"
)
Déanann an móideán measúnú ar an iarratas agus cinneann sé:
- Má theastaíonn sonraí seachtracha don iarratas → glaonn sé ar uirlis
- Má is féidir leis freagra a thabhairt go díreach → freagraíonn sé gan uirlis
Is é seo an mód is coitianta agus is nádúrtha. Bain úsáid as nuair a chuireann tú muinín as breithiúnas an mhóidín.
Mód required
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="required"
)
Caithfidh an móideán glao a chur ar uirlis amháin ar a laghad. Ní féidir leis freagra a thabhairt go díreach, fiú má tá an freagra ar eolas aige cheana féin. Cásanna úsáide:
- Eastóscadh struchtúrtha: Ba mhaith leat an móideán a chiallú chun sonraí a eastóscadh i bhformáid shonrach trí uirlis tiomnaithe
- Fíorú éigeantach: Caithfidh gach iarratas dul trí uirlis fíoraithe
- Logáil chórasach: Ní mór gach rud a rianú trí uirlis logála
Mód none
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice="none"
)
Díchumasaíonn sé glaoch feidhme go hiomlán don iarratas seo. Feiceann an móideán na sainmhínithe uirlisí (fanann siad sa chomhthéacs) ach ní féidir leis glaoch orthu. Cásanna úsáide:
- Céim shoiléirithe: Ba mhaith leat go gcuirfeadh an móideán ceisteanna sula ndéanfadh sé gníomh
- Mód réamhamhairc: Taispeáin cad a dhéanfadh an móideán gan é a fhorghníomhú
- Cúltaisce: Má tá uirlisí ar fáil go sealadach
Mód sonrach (uirlis shonrach a fhorchur)
response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={
"type": "function",
"function": {"name": "get_weather"}
}
)
Tá an móideán faoi iallach an uirlis seo amháin a ghlaoch. Ní féidir leis ceann eile a roghnú, ná freagra a thabhairt go díreach. Is é seo an mód is sriantaí. Cásanna úsáide:
- Sreabhadh oibre seicheamhach: Ag an gcéim seo, ní mór an uirlis shonrach seo a ghlaoch
- Tástálacha: Ba mhaith leat a fhíorú go ngineann an móideán na hargóintí cearta d’uirlis ar leith
- Eastóscadh spriocdhírithe: Tá a fhios agat cén uirlis le húsáid agus ní theastaíonn uait ach go n-eastósódh an móideán na paraiméadair
Comparáid idir móid
| Mód | Iompar | Cathain é a úsáid |
|---|---|---|
| auto | Cinneann an móideán go saor | Cás ginearálta, chatbotaí |
| required | Ní mór glao a chur ar uirlis amháin ar a laghad | Eastóscadh, fíorú |
| none | Níl aon uirlisí ceadaithe | Soiléiriú, cúltaisce |
| {"function":...} | Forchuireann sé uirlis shonrach | Sreabhadh oibre, tástálacha |
Straitéisí casta
Móid a mhalartú i sreabhadh oibre
Is féidir le sreabhadh oibre cliste tool_choice a athrú ag brath ar an gcéim:
# Céim 1: cuardach a fhorchur
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
tool_choice={"type": "function", "function": {"name": "search_products"}}
)
# Céim 2: lig don mhóideán cinneadh (anailís nó ceist)
response2 = client.chat.completions.create(
model="grok-4.5",
messages=updated_messages,
tools=tools,
tool_choice="auto"
)
Comhcheangal leis an leid chórais
Is féidir leis an leid chórais treoir a thabhairt don mhóideán ina roghanna uirlisí fiú sa mhód auto:
messages = [
{
"role": "system",
"content": "Is cúntóir taistil tú. Bain úsáid i gcónaí as "
"get_weather sula molann tú gníomhaíochtaí faoin aer."
},
{"role": "user", "content": "Cad ba chóir dom a dhéanamh i Marseille an deireadh seachtaine seo?"}
]
Príomhphointí
auto: Cinneann an móideán (réamhshocraithe, moltar é don chuid is mó de na cásanna)required: Forchuireann sé glaoch ar uirlis amháin ar a laghadnone: Díchumasaíonn sé glaoch feidhme go sealadach- Mód sonrach: Forchuireann sé glaoch ar uirlis shonrach de réir ainm
- Malartaigh móid i sreabhadh oibre le haghaidh rialú mine
- Comhcheangail
tool_choiceleis an leid chórais chun treoir a thabhairt don mhóideán