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

Eżegwixxi u Rritorna r-Riżultat

Lezzjoni 6 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Il-Pass Li Tikkontrolla Għalkollox
  2. Eżegwixxi l-Funzjoni fuq in-Naħa tal-Klijent
  3. Ibni l-Messaġġ tal-Għodda (Tool Message)
  4. Ibghat ir-Riżultat u Ikseb ir-Risposta Finali
  5. Iċ-Ċirkwit Sħiħ f’Blokk Wieħed
  6. L-Istruttura tal-Messaġġ f’Kull Pass
  7. Ara l-Format tal-Kontenut
  8. Punti Ewlenin

Il-Pass Li Tikkontrolla Għalkollox

Irċevejt tool_call mill-mudell. Dan jgħidlek liema funzjoni għandek isejjaħ u b’liema argumenti—xejn aktar. Issa il-kodiċi tiegħek jieħu l-kontroll: jeżegwixxi l-funzjoni, jirkupra r-riżultat, u jibgħatu lura lill-mudell bħala messaġġ bir-rwol tool. Din il-lezzjoni tkopri dan iċ-ċiklu sħiħ. Dan huwa l-uniku mument fiċ-ċiklu fejn inti tieħu d-deċiżjonijiet kollha.

Eżegwixxi l-Funzjoni fuq in-Naħa tal-Klijent

Ejja nerġgħu naraw id-dizzjunarju ta’ dispatch mil-Lezzjoni 4 u nqabbduh mar-risposta tal-mudell.

import json
from functools import partial

# Funzjonijiet diġà definiti
available_functions = {
    "retrieve_payment_status": partial(retrieve_payment_status, df),
    "retrieve_payment_date": partial(retrieve_payment_date, df),
}

# Il-mudell irritorna tool_call
tool_call = response.choices[0].message.tool_calls[0]
function_name = tool_call.function.name
function_params = json.loads(tool_call.function.arguments)

# Eżegwixxi l-funzjoni
if function_name in available_functions:
    result = available_functions[function_name](**function_params)
    print(f"Result: {result}")
    # → '{"status": "paid"}'
else:
    result = json.dumps({"error": f"Function {function_name} not available"})

Hemm żewġ mekkaniżmi jaħdmu hawnhekk. L-ewwel huwa **function_params, li jiftaħ id-dizzjunarju mill-JSON f’argumenti msemmija: jekk il-mudell iġġenera {"transaction_id": "T1001"}, is-sejħa hija eżattament ekwivalenti għal retrieve_payment_status(transaction_id="T1001"). It-tieni huwa l-blokk else. Huwa inqas impressjonanti iżda essenzjali. Mudell jista’ jalluċina isem ta’ funzjoni li ma teżistix fid-dispatch tiegħek; mingħajr din iċ-ċekka, l-app tiegħek iqajjem KeyError u l-konversazzjoni tieqaf għal kollox. Bih, l-iżball isir data li l-mudell jista’ jimmaniġġja b’mod grazzjuż.

Ibni l-Messaġġ tal-Għodda (Tool Message)

Ir-riżultat irid jerġa’ lura għand il-mudell f’format speċifiku—messaġġ bir-rwol "tool":

tool_message = {
    "role": "tool",
    "name": function_name,
    "content": result,  # Irid ikun stringa
    "tool_call_id": tool_call.id
}
KampRwol
role"tool"—jidentifika l-messaġġ bħala riżultat ta’ funzjoni
nameL-isem tal-funzjoni eżegwita
contentIr-riżultat bħala stringa JSON
tool_call_idL-ID tal-tool_call oriġinali—jħalli lill-mudell iqabbel ir-riżultat mas-sejħa t-tajba

Ibghat ir-Riżultat u Ikseb ir-Risposta Finali

Il-mudell m’għandux memorja minn sejħa għall-oħra: ma jiftakarx li talab xi ħaġa mingħandek. Għalhekk, trid tibni mill-ġdid il-konversazzjoni kollha għalih, inkluża t-talba tiegħu stess għal sejħa ta’ għodda, qabel ma tippreżenta r-riżultat.

# 1. Żid il-messaġġ tal-assistent (bit-tool_call)
messages.append(response.choices[0].message)

# 2. Żid ir-riżultat tal-funzjoni
messages.append({
    "role": "tool",
    "name": function_name,
    "content": result,
    "tool_call_id": tool_call.id
})

# 3. Sejjaħ il-mudell mill-ġdid bil-kuntest sħiħ
final_response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools
)

# 4. Uri r-risposta finali
print(final_response.choices[0].message.content)
# → "Payment T1001 status is: paid."

L-ordni taż-żewġ operazzjonijiet append mhix negozjabbli: il-messaġġ tal-assistent li jġorr it-tool_call irid jiġi qabel il-messaġġ tool li jwieġbu. Jekk tibdlhom, toħloq storja inkonsistenti li l-API tiċħad.

Iċ-Ċirkwit Sħiħ f’Blokk Wieħed

Hawnhekk hemm il-proċess kollu, mill-mistoqsija tal-utent sat-tweġiba finali:

import os
import json
from mistralai.client import Mistral
from functools import partial

# Konfigurazzjoni
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
model = "mistral-large-latest"

# Funzjonijiet u għodod (definiti qabel)
available_functions = {
    "retrieve_payment_status": partial(retrieve_payment_status, df),
    "retrieve_payment_date": partial(retrieve_payment_date, df),
}

# Passi 1-2: Mistoqsija tal-utent + Sejħa API
messages = [
    {"role": "user", "content": "What is the status of payment T1001?"}
]

response = client.chat.complete(
    model=model, messages=messages, tools=tools
)

# Passi 3-4: Estrai t-tool_call u eżegwixxi
message = response.choices[0].message

if message.tool_calls:
    tool_call = message.tool_calls[0]
    function_name = tool_call.function.name
    function_params = json.loads(tool_call.function.arguments)

    # Eżekuzzjoni fuq in-naħa tal-klijent
    result = available_functions[function_name](**function_params)

    # Pass 5: Ibghat ir-riżultat lura lill-mudell
    messages.append(message)
    messages.append({
        "role": "tool",
        "name": function_name,
        "content": result,
        "tool_call_id": tool_call.id
    })

    final_response = client.chat.complete(
        model=model, messages=messages, tools=tools
    )
    print(final_response.choices[0].message.content)
else:
    print(message.content)

L-Istruttura tal-Messaġġ f’Kull Pass

Jiswa l-penn li tispezzjona l-lista messages darba li ċ-ċiklu jintemm, għax din hija l-aħjar mod biex tiddibbuggja sejħiet ta’ funzjonijiet li ma jaħdmux tajjeb. Fiha erba’ messaġġi.

# Messaġġ 1: Il-mistoqsija tal-utent
{"role": "user", "content": "What is the status of payment T1001?"}

# Messaġġ 2: Ir-risposta tal-mudell bit-tool_call
{"role": "assistant", "tool_calls": [{"id": "call_abc123", ...}]}

# Messaġġ 3: Ir-riżultat tal-funzjoni
{"role": "tool", "name": "retrieve_payment_status",
 "content": '{"status": "paid"}', "tool_call_id": "call_abc123"}

# Messaġġ 4 (impliċitu): Ir-risposta finali tal-mudell
# → "Payment T1001 status is: paid."

Segwi l-ID call_abc123: titwieled fil-Messaġġ 2 u terġa’ tidher fil-Messaġġ 3. Dak il-fil jgħaqqad it-talba mat-tweġiba tagħha. Din l-istruttura hija l-mudell fundamentali tas-sejħa tal-funzjonijiet; kull varjazzjoni li tiltaqa’ magħha aktar tard, kemm jekk multi-turn jew parallela, sempliċement tirrepetiha jew tiddupplikaha.

Ara l-Format tal-Kontenut

Żball wieħed jidher aktar spiss mill-oħrajn kollha, u jiġi mit-tip tal-kamp content: irid ikun dejjem stringa.

# Korrett — stringa JSON
{"content": '{"status": "paid"}'}

# Korrett — test sempliċi
{"content": "The status is paid"}

# Żbaljat — dizzjunarju Python (se jikkawża żball)
{"content": {"status": "paid"}}

Id-differenza bejn l-ewwel u t-tielet eżempju tinsab fil-kwotazzjonijiet li jduru mal-JSON. Jekk il-funzjoni tiegħek tirritorna dizzjunarju, ikkonvertiha b’json.dumps() qabel ma tibgħatha—dan huwa preċiżament għaliex il-funzjonijiet fil-Lezzjoni 4 kollha ntemmu b’json.dumps().

Punti Ewlenin

  • L-eżekuzzjoni tal-funzjoni sseħħ fuq in-naħa tal-klijent, fil-kodiċi tiegħek—qatt mill-mudell
  • Ir-riżultat jintbagħat lura f’messaġġ bir-rwol "tool" u bl-tool_call_id korrispondenti
  • Il-content tal-messaġġ tal-għodda irid ikun stringa (stringa JSON)
  • Wara li tibgħat ir-riżultat, isejjaħ chat.complete() mill-ġdid biex il-mudell ikun jista’ jifformula r-risposta finali
  • Dejjem ivverifika li l-funzjoni mitluba teżisti fid-dizzjunarju ta’ dispatch tiegħek