Eżegwixxi u Rritorna r-Riżultat
F'din il-paġna
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
}
| Kamp | Rwol |
|---|---|
role | "tool"—jidentifika l-messaġġ bħala riżultat ta’ funzjoni |
name | L-isem tal-funzjoni eżegwita |
content | Ir-riżultat bħala stringa JSON |
tool_call_id | L-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_idkorrispondenti - Il-
contenttal-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