Il-Proċess f'5 Passi
Protokoll ċar bejnek u l-mudell
Is-sejħa tal-funzjonijiet ta’ Mistral issegwi proċess definit sew ta’ ħames passi. Dak li jagħmel dan il-protokoll leġibbli huwa li kull pass għandu sid wieħed biss: jew int (l-iżviluppatur), il-mudell, jew l-utent. L-ebda pass ma huwa kondiviż, u l-ebda wieħed mhu ambigwu. Ħu ħinek biex tifhem din id-diviżjoni tax-xogħol qabel ma tikteb linja waħda ta’ kodiċi: il-biċċa l-kbira tal-bugs fis-sejħa tal-funzjonijiet iseħħu meta żviluppatur jistenna li l-mudell jittratta pass li fil-fatt huwa r-responsabbiltà tiegħu.
Iddefinixxi l-funzjonijiet (L-Iżviluppatur)
Int tiddeskrivi kull funzjoni disponibbli b'schema JSON: isem, deskrizzjoni, parametri, tipi, u oqsma meħtieġa. Il-mudell jara biss din l-ispeċifikazzjoni, mhux il-kodiċi tiegħek.
L-utent jagħmel mistoqsija (L-Utent)
L-utent jagħmel il-mistoqsija tiegħu bil-lingwa naturali. Int tibgħat din it-talba lill-mudell Mistral flimkien mal-lista tal-għodod disponibbli.
Iġġenera l-argumenti (Il-Mudell)
Il-mudell janalizza t-talba, jagħżel il-funzjoni xierqa, u jiġġenera l-argumenti f'format JSON. Ma jesegwix il-funzjoni— sempliċiment jgħidlek x'għandek isejjaħ u b'liema parametri.
Esegwixxi l-funzjoni (L-Iżviluppatur)
Il-kodiċi tiegħek jipproċessa l-isem tal-funzjoni u l-argumenti mir-rispons tal-mudell, iħaddem il-funzjoni korrispondenti, u jirkupra r-riżultat.
Iġġenera r-rispons finali (Il-Mudell)
Int tibgħat ir-riżultat tal-funzjoni lura lill-mudell. Dan jintegra r-riżultat fil-kuntest tal-konversazzjoni u jifformula tweġiba naturali għall-utent.
Il-fluss fid-dettall
Dawn il-ħames passi jimmappjaw direttament mal-kodiċi. Ejja ngħaddu minnhom bl-użu ta’ eżempju wieħed, intenzjonalament minimu: utent irid jaf l-istatus tal-ħlas T1001. Se nużaw dan l-istess eżempju bħala l-fil konduttur tagħna sal-aħħar tal-blokk “Implimentazzjoni f’Python”, allura familjarizza ruħek mal-identifikaturi tiegħu issa.
Pass 1: Int tiddefinixxi l-għodod
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"]
}
}
}
]
Xejn hawnhekk mhu kodiċi eżegwibbli: hija deskrizzjoni. Il-mudell jitgħallem li teżisti funzjoni msejħa get_payment_status, x’tagħmel, u li teħtieġ transaction_id tat-tip stringa. Qatt ma jitgħallem kif il-funzjoni hija implimentata.
Pass 2: L-utent jagħmel il-mistoqsija tiegħu
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
Pass 3: Il-mudell jiġġenera l-argumenti
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"}'
Il-mudell estratta “T1001” mis-sentenza u poġġiha fl-oqsma korretti. Innota li arguments jaslu bħala stringa, mhux bħala dizzjunarju: se tittratta dak id-dettall fil-pass li jmiss.
Pass 4: Int tesegwixxi l-funzjoni
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"}
Pass 5: Il-mudell jifformula r-rispons
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."
Żewġ messaġġi jiżdiedu mal-istorja, qatt wieħed biss: il-messaġġ tal-assistent li jġorr it-talba tas-sejħa, segwit mill-messaġġ li jġorr ir-riżultat. L-tool_call_id jgħaqqad iż-żewġ partijiet. Ħassar wieħed minnhom u l-API tirrifjuta t-talba, jew il-mudell se jwieġeb barra mit-tema.
Mudelli ta’ fluss
Skont il-kumplessità tat-talba, dan il-fluss jista’ jieħu forom differenti. L-aktar każ sempliċi huwa meta ma tinvolvi l-ebda funzjoni: l-utent jagħmel mistoqsija ġenerali—“X’tista’ tagħmel?”—u l-mudell iwieġeb direttament mingħajr qatt ma jmiss l-għodod. Imbagħad hemm is-sejħa sempliċi li għadna kemm rajna: funzjoni waħda, riżultat wieħed, tweġiba waħda.
Iż-żewġ forom li jmiss huma aktar interessanti. F’katina sekwenzjali, il-mudell isejjaħ l-ewwel funzjoni, jaqra r-riżultat, u jużah biex jiddeċiedi dwar it-tieni sejħa—tipikament biex jirkupra ID ta’ klijent qabel ma jikkonsulta l-fatturi tiegħu. F’sejħa parallela, jitlob l-eżekuzzjoni ta’ funzjonijiet multipli f’daqqa għax l-ebda waħda ma tiddependi mill-oħra. Se niddedikaw lezzjonijiet sħaħ għal dawn iż-żewġ mudelli; għalissa, ftakar li t-tnejn jiddependu eżattament fuq il-ħames passi ta’ hawn fuq, sempliċiment ripetuti.
Punti Ewlenin
- Is-sejħa tal-funzjonijiet issegwi proċess ta’ 5 passi b’responsabbiltajiet ċari
- Il-mudell qatt ma jista’ jesegwixxi funzjoni direttament—jiġġenera biss l-argumenti
- Il-kodiċi tiegħek huwa l-gwardjan: jiddeċiedi jekk jesegwixxix il-funzjoni jew le
- Ir-riżultat tal-funzjoni jintbagħat lura lill-mudell sabiex dan ikun jista’ jifformula tweġiba naturali
- Il-fluss jista’ jkun sempliċi (sejħa waħda) jew kumpless (sekwenzzjali, parallel)