Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

tool_choice agus rialú

Ceacht 5 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Rialú ar iompar an mhóidín
  2. Na ceithre mhód tool_choice
  3. Comparáid idir móid
  4. Straitéisí casta
  5. Príomhphointí

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 laghad
  • none: 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_choice leis an leid chórais chun treoir a thabhairt don mhóideán