Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Il-Proċess f'5 Passi

Lezzjoni 2 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Protokoll ċar bejnek u l-mudell
  2. Il-fluss fid-dettall
  3. Mudelli ta’ fluss
  4. Punti Ewlenin

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.

1

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.

2

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.

3

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.

4

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.

5

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)