An Próiseas 5 Chéim
Ar an leathanach seo
Prótacal soiléir idir tú féin agus an tsamhail
Leanann glao feidhme Mistral próiseas cúig chéim atá sainmhínithe go maith. Is é an rud a dhéanann an prótacal seo inléite ná go bhfuil úinéir amháin ag gach céim: either tú féin (an forbróir), an tsamhail, nó an t-úsáideoir. Níl aon chéim roinnte, agus níl aon cheann ambíguach. Tóg do chuid ama chun an roinnt oibre seo a mheabhrú sula scríobhann tú aon líne cóid: tarlaíonn an chuid is mó de bhotúin ghlaonna feidhme nuair a bhíonn súil ag forbróir go ndéanfaidh an tsamhail céim nach mbaineann léi ach leisean féin.
Sainigh na feidhmeanna (Forbróir)
Déanann tú cur síos ar gach feidhm atá ar fáil le scéama JSON: ainm, cur síos, paraiméadair, cineálacha, agus réimsí éigeantacha. Ní fheiceann an tsamhail ach an tsainmhíniú seo, ní do chód.
Cuirann an t-úsáideoir ceist (Úsáideoir)
Cuirann an t-úsáideoir a cheist i ngnáththeanga. Seolann tú an t-iarratas seo chuig samhail Mistral in éineacht leis an liosta uirlisí atá ar fáil.
Gin na hargóintí (Samhail)
Déanann an tsamhail anailís ar an iarratas, roghnaíonn sí an fheidhm oiriúnach, agus gineann sí na hargóintí i bhformáid JSON. Ní dhéanann sí an fheidhm a fhorghníomhú—ní insíonn sí duit ach cad le glaoch air agus le cé na paraiméadair.
Forghníomhaigh an fheidhm (Forbróir)
Baineann do chód ainm na feidhme agus na hargóintí as freagra na samhla, ritheann sé an fheidhm chomhfhreagrach, agus faigheann sé an toradh.
Gin an fhreagra dheiridh (Samhail)
Seolann tú toradh na feidhme ar ais chuig an tsamhail. Cuireann sí an toradh isteach i gcomhthéacs an chomhrá agus déanann sí freagra nádúrtha a fhoirmliú don úsáideoir.
An sreabhadh go mion
Mapálann na cúig chéim seo go díreach ar chód. Déanaimis iad a shiúl trí shampla amháin atá beartaithe a bheith íosta: tá an t-úsáideoir ag iarraidh stádas íocaíochta T1001 a fháil amach. Úsáidfimid an sampla céanna seo mar snáithe reatha tríd an mbloc “Cur i bhFeidhm Python” go dtí an deireadh, mar sin bíodh na haitheantóirí seo ar eolas agat anois.
Céim 1: Sainíonn tú na huirlisí
tools = [
{
"type": "function",
"function": {
"name": "get_payment_status",
"description": "Retrieves the status of a payment given its transaction ID",
"parameters": {
"type": "object",
"properties": {
"transaction_id": {
"type": "string",
"description": "The unique transaction identifier (e.g., T1001)"
}
},
"required": ["transaction_id"]
}
}
}
]
Níl aon rud anseo ina chód in-fhorghníomhaithe: is cur síos atá ann. Foghlaimíonn an tsamhail go bhfuil feidhm darb ainm get_payment_status ann, cad a dhéanann sí, agus go dteastaíonn transaction_id de chineál teaghrán uaithi. Ní fhoghlaimíonn sí riamh conas a chuirtear an fheidhm i bhfeidhm.
Céim 2: Cuirann an t-úsáideoir a cheist
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
Céim 3: Gineann an tsamhail na hargóintí
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools
)
# The model returns a tool_call:
# function.name = "get_payment_status"
# function.arguments = '{"transaction_id": "T1001"}'
Bhain an tsamhail “T1001” as an abairt agus chuir sí sa réimse ceart é. Tabhair faoi deara go dtagann arguments mar theaghrán, ní mar fhoclóir: déileálfaidh tú leis an mionsonra sin sa chéad chéim eile.
Céim 4: Forghníomhaíonn tú an fheidhm
import json
tool_call = response.choices[0].message.tool_calls[0]
args = json.loads(tool_call.function.arguments)
result = get_payment_status(**args)
# → {"status": "paid", "date": "2026-03-15"}
Céim 5: Foirmlíonn an tsamhail an fhreagra
messages.append(response.choices[0].message)
messages.append({
"role": "tool",
"name": "get_payment_status",
"content": json.dumps(result),
"tool_call_id": tool_call.id
})
final = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools
)
print(final.choices[0].message.content)
# → "Payment T1001 was made on March 15, 2026."
Cuirtear dhá theachtaireacht leis an stair, riamh ní ceann amháin: an teachtaireacht chúnta a iompraíonn an t-iarratas glaonna, agus ina dhiaidh sin an teachtaireacht a iompraíonn an toradh. Nascann an tool_call_id an dá cheann. Fág ceann ar bith acu ar lár agus diúltóidh an API an t-iarratas, nó freagróidh an tsamhail lasmuigh den ábhar.
Patrúin sreafa
Ag brath ar chastacht an iarratais, is féidir leis an sreabhadh seo cruthanna éagsúla a ghlacadh. Is é an cás is simplí ná nuair nach bhfuil aon fheidhm i gceist: cuireann an t-úsáideoir ceist ghinearálta—“Cad is féidir leat a dhéanamh?”—agus freagraíonn an tsamhail go díreach gan na huirlisí a shuathadh riamh. Ansin tagann an glao simplí a shiúil muid díreach: feidhm amháin, toradh amháin, freagra amháin.
Tá an dá fhoirm seo a leanas níos suimiúla. I slabhra seicheamhach, glaonn an tsamhail ar chéad fheidhm, léann sí an toradh, agus úsáideann sí é chun cinneadh a dhéanamh ar dhara glao—go hiondúil ag aisghabháil ID custaiméara sula ndéanann sí fiosrúchán ar a gcuid sonraisc. I nglao comhthreomhar, iarrann sí forghníomhú ilfheidhmeanna ag an am céanna toisc nach mbraitheann aon cheann acu ar an gceann eile. Tiomnóimid ceachtanna iomlána don dá phatrún seo; faoi láthair, cuimhnigh go mbraitheann an dá cheann ar na cúig chéim thuas go díreach, ach amháin go ndéantar iad a athdhéanamh.
Príomhphointí
- Leanann glao feidhme próiseas 5 chéim le freagrachtaí soiléire
- Ní féidir leis an tsamhail feidhm a fhorghníomhú go díreach riamh—ní ghineann sí ach argóintí
- Is é do chód an garda geata: is é a chinneann an ndéanfar an fheidhm a fhorghníomhú nó nach ndéanfar
- Seoltar toradh na feidhme ar ais chuig an tsamhail ionas gur féidir léi freagra nádúrtha a fhoirmliú
- Is féidir leis an sreabhadh a bheith simplí (glao amháin) nó casta (seicheamhach, comhthreomhar)