Roghanna tool_choice
Ar an leathanach seo
Cinneadh a dhéanamh ar an gCinneadh
Ní chiallaíonn tools a chur ar fáil don API go gcaithfidh an tsamhail iad a úsáid, nó fiú go bhfuil cead aici déanamh amhlaidh. Idir an dá cheann sin, feidhmíonn an paraiméadar tool_choice mar idirghabhálaí. Ag brath ar an luach a shannann tú, is féidir leat saoirse a thabhairt don tsamhail breithiúnas a dhéanamh, é a iallach glaoch struchtúrtha a tháirgeadh, nó a rochtain ar na huirlisí a d’fhógair tú díreach a chúlghairm go hiomlán. Is socruithe mín iad seo, ach athraíonn siad go radacach an chaoi a n-iompraíonn an cód céanna nuair a bhíonn sé os comhair na ceiste céanna.
| Luach | Iompar | Cás Úsáide |
|---|---|---|
auto | Cinneann an tsamhail go saor an úsáidfear uirlis nó an bhfreagrófar i dtéacs. Seo an mód réamhshocraithe. | Cúntóirí comhrá, chatbotaí ginearálta |
any | Ialtar ar an tsamhail glaoch a dhéanamh ar uirlis amháin ar a laghad. Ní féidir léi freagairt le téacs amháin. | Píblínte uathoibrithe, eastóscadh sonraí struchtúrtha |
none | Ní féidir leis an tsamhail uirlisí a úsáid, fiú má tá siad sainithe. Freagraíonn sí le téacs amháin. | Achoimriú torthaí gan glaonna nua, athfhráisiú freagartha |
required | Comhchiallach le any. Caithfidh an tsamhail uirlis amháin ar a laghad a úsáid. | Coibhéiseach le any, le haghaidh comhoiriúnachta |
auto — Lig don tSamhail Breithiúnas a Dhéanamh
Seo an luach réamhshocraithe, an ceann a úsáideann tú gan a bheith ar an eolas faoi gach uair a fhágann tú an paraiméadar ar lár.
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools,
tool_choice="auto" # Roghnach, seo an luach réamhshocraithe
)
Le auto, déanann an tsamhail measúnú ar an iarratas sula ngníomhaíonn sí. Má éilíonn an cheist sonraí seachtracha nach bhfuil aici, glaonn sí ar fheidhm; má tá an cheist ghinearálta nó gaolmhar, freagraíonn sí go díreach i dtéacs. Is é an lasc seo a dhéanann cúntóir a bheith nádúrtha: ní gá don úsáideoir a bheith ar an eolas go bhfuil uirlisí taobh thiar den scáileán.
# Glaoifidh an tsamhail ar fheidhm
messages = [{"role": "user", "content": "Stádas íocaíochta T1001?"}]
# → tool_call: retrieve_payment_status(transaction_id="T1001")
# Freagróidh an tsamhail go díreach
messages = [{"role": "user", "content": "Dia dhuit, conas atá tú?"}]
# → content: "Dia dhuit! Is cúntóir íocaíochta mé. Conas is féidir liom cabhrú leat?"
Tuilleann an dara sampla aird: dá n-ialtaí glaoch feidhme ar bheannacht shimplí, chruthófaí retrieve_payment_status le ID bréagach. Sin díreach an rud a chuireann auto cosc air, agus sin an fáth go bhfanann an mód seo mar an ceann is coitianta i dtáirgeadh.
any — Cur i bhFeidhm Aschur Struchtúrtha
Ar an láimh eile, tá comhthéacsanna ann nach bhfuil aon luach ag baint le téacs saorchruthach duitse. Bíonn píblíne ionghabhála ag próiseáil deich míle doiciméad ag súil le JSON inúsáidte, ní le habairt chuíchreachtach. Le any, caithfidh an tsamhail glaoch a dhéanamh ar fheidhm amháin ar a laghad, fiú mura dealraíonn sé go n-éilíonn an cheist é.
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools,
tool_choice="any"
)
Go suimiúil, athúsáideann an cás úsáide is minic glaonna feidhme óna bhunchuspóir: ní ag dearbhú feidhme lena cur i gcrích atá tú, ach chun scéama aschuir a ráthú. Anseo, ní ghlaofar ar extract_entities riamh ar an taobh freastalaí; is é an conradh JSON atá tábhachtach dúinn.
# Eastóscadh struchtúrtha: ialtaigh ar an tsamhail sonraí a eastóscadh
tools = [{
"type": "function",
"function": {
"name": "extract_entities",
"description": "Extracts named entities from text",
"parameters": {
"type": "object",
"properties": {
"persons": {"type": "array", "items": {"type": "string"}},
"organizations": {"type": "array", "items": {"type": "string"}},
"dates": {"type": "array", "items": {"type": "string"}}
},
"required": ["persons", "organizations", "dates"]
}
}
}]
messages = [{"role": "user", "content": "Sophia Yang from Mistral presented "
"function calling on March 15, 2026."}]
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools,
tool_choice="any" # Ialtaigh eastóscadh
)
# → extract_entities(persons=["Sophia Yang"],
# organizations=["Mistral"],
# dates=["March 15, 2026"])
Tabhair faoi deara required ar an taobh: is comhchiallach é le any, cuimsithe le haghaidh comhoiriúnachta le cód a scríobhadh do APIanna eile. Táirgeann an dá luach an t-iompar céanna; roghnaigh an ceann a dhéanann do chód is inléite agus fan leis.
none — Uirlisí a Dhíchumasú Gan Iad a Bhaint
Freagraíonn an tríú luach ar riachtanas nach bhfuil chomh soiléir sin. Tá do chuid sonraí faighte agat cheana féin trí roinnt tool_calls, agus anois ba mhaith leat leis an tsamhail iad a shintéisiú. Má leanann tú ar aghaidh leis an gcomhrá sa mhód auto, ní chuireann aon rud cosc ar an tsamhail glaoch a dhéanamh ar fheidhm arís “chun seiceáil”, rud a mhéadaíonn moill agus a d’fhéadfadh lúb gan deireadh a spreagadh. Cuireann none cosc ar aon ghlaonna nua agus na sainmhínithe uirlisí á gcoinneáil sa chomhthéacs, ag cabhrú leis an tsamhail labhairt go cruinn faoi na sonraí atá aici cheana féin.
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools,
tool_choice="none"
)
Tagann trí chás úsáide chun cinn go minic: achoimre a iarraidh tar éis sraith glaonna feidhme, freagra a athfhráisiú gan glaonna nua a spreagadh, agus tástáil i bhforbairt ar an gcaoi a n-iompraíonn an tsamhail nuair a bhaintear a cuid uirlisí di, rud a nochtann go tapa ceisteanna a shíleann sí gur féidir léi a fhreagairt ón gcuimhne.
# Tar éis sonraí a fháil trí tool_calls...
# Iarr achoimre gan glaonna nua
messages.append({
"role": "user",
"content": "Déan achoimre ar an bhfaisnéis ó na híocaíochtaí go léir a fuair tú."
})
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools,
tool_choice="none" # Déanann an tsamhail achoimre leis an méid atá aici cheana
)
Coigeartaigh an Socruithe Le Linn an Chomhrá
Ní gá duit tool_choice a shocrú uair amháin ag am tosaithe. I dtáirgeadh, is gnách é a ríomh ag gach casadh bunaithe ar an gcomhthéacs: an chéad teachtaireacht den chomhrá, an rún a braitheadh san iarratas, nó líon na nglaonna a úsáideadh cheana. Léiríonn an fheidhm thíos an loighic seo ina foirm is simplí—fanann an tsamhail saor de réir réamhshocraithe, ach amháin nuair a iarrann an t-úsáideoir achoimre go sonrach.
def get_tool_choice(user_input: str, turn_count: int) -> str:
"""Cinneann tool_choice bunaithe ar an gcomhthéacs."""
# An chéad chasadh: lig don tsamhail cinneadh
if turn_count == 0:
return "auto"
# Má iarrann an t-úsáideoir achoimre go sonrach
if any(word in user_input.lower() for word in ["summarize", "recap", "synthesis"]):
return "none"
# Réamhshocraithe
return "auto"
Go praiticiúil, coinnigh auto mar do shocrú bonnlíne: is é an ceann is nádúrtha agus is solúbtha. Cuir any in áirithe do phíblínte eastóscadh sonraí struchtúrtha, agus none do mhómaintí nuair a chaithfidh tú lúba gan deireadh tool_call a chosc. Tá srian amháin absalóideach: ná hathraigh tool_choice riamh i lár próiseála tool_call. Críochnaigh an timthriall ar dtús trí gach teachtaireacht tool a bhfuiltear ag súil léi a thabhairt ar ais, ansin coigeartaigh an paraiméadar ar an gcéad chasadh eile—mura ndéantar é sin, éireoidh an stair neamhréireach agus diúltóidh an API an t-iarratas.
Príomhphointí
- Rialaíonn
tool_choicecathain a úsáideann an tsamhail feidhmeanna auto= cinneann an tsamhail go saor (réamhshocraithe, molta do chatbotaí)any= ialtaigh ar an tsamhail glaoch a dhéanamh ar uirlis (píblínte, eastóscadh struchtúrtha)none= tá uirlisí díchumasaithe (achoimrí, athfhráisiú)- Oiriúnaigh
tool_choicego dinimiciúil bunaithe ar chomhthéacs an chomhrá