Feidhmiú agus Toradh a Thabhairt Ar Ais
Ar an leathanach seo
An Céim atá faoi do Smacht Iomlán
Fuair tú tool_call ón tsamhail. Inseann sé duit cén fheidhm le glaoch agus cé na hargóintí le húsáid—níl aon rud eile ann. Anois glacann do chód seilbh: feidhmíonn sé an fheidhm, faigheann sé an toradh, agus seolann sé ar ais chuig an tsamhail é mar theachtaireacht leis an ról tool. Clúdaíonn an ceacht seo an turas slán sin. Is é seo an t-aon nóiméad sa timthriall ina ndéanann tú gach cinneadh.
An Fheidhm a Fheidhmiú ar an gCliant
Déanaimis athbhreithniú ar an bhfoclóir seolta ó Cheacht 4 agus nascaimis é le freagra na samhla.
import json
from functools import partial
# Feidhmeanna sainithe cheana
available_functions = {
"retrieve_payment_status": partial(retrieve_payment_status, df),
"retrieve_payment_date": partial(retrieve_payment_date, df),
}
# Thug an tsamhail tool_call ar ais
tool_call = response.choices[0].message.tool_calls[0]
function_name = tool_call.function.name
function_params = json.loads(tool_call.function.arguments)
# Feidhmigh an fheidhm
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"})
Tá dhá mheicníocht ag obair anseo. Is é an chéad cheann **function_params, a dhíphacálann an foclóir ón JSON go dtí argóintí ainmnithe: má ghin an tsamhail {"transaction_id": "T1001"}, tá an glao coibhéiseach go díreach le retrieve_payment_status(transaction_id="T1001"). Is é an dara ceann an bloc else. Níl sé chomh gléineach sin ach tá sé riachtanach. D’fhéadfadh samhail ainm feidhme a bhrionglóidiú nach bhfuil i do fhoclóir seolta; gan an seiceáil seo, ardóidh do aip KeyError agus stopfaidh an comhrá go hiomlán. Leis an seiceáil seo, déantar sonraí den earráid ar féidir leis an tsamhail déileáil leo go réidh.
An Teachtaireacht Uirlise a Thógáil
Caithfear an toradh a chur ar ais chuig an tsamhail i bhformáid shonrach—teachtaireacht leis an ról "tool":
tool_message = {
"role": "tool",
"name": function_name,
"content": result, # Ní mór gur teaghrán é
"tool_call_id": tool_call.id
}
| Réimse | Ról |
|---|---|
role | "tool"—aithníonn sé an teachtaireacht mar thoradh feidhme |
name | Ainm na feidhme a feidhmíodh |
content | An toradh mar theaghrán JSON |
tool_call_id | ID an tool_call bunaidh—ligeann sé don tsamhail an toradh a mheaitseáil leis an nglao ceart |
An Toradh a Sheoladh agus an Freagra Deiridh a Fháil
Níl cuimhne ag an tsamhail ó ghlao go glao: ní chuimhníonn sí gur iarr sí rud éigin ort. Mar sin, ní mór duit an comhrá iomlán a athchruthú di, lena n-áirítear a hiarraidh féin ar ghlao uirlise, sula gcuireann tú an toradh i láthair.
# 1. Cuir an teachtaireacht cúntóra leis (leis an tool_call)
messages.append(response.choices[0].message)
# 2. Cuir toradh na feidhme leis
messages.append({
"role": "tool",
"name": function_name,
"content": result,
"tool_call_id": tool_call.id
})
# 3. Glaoigh ar an tsamhail arís leis an gcomhthéacs iomlán
final_response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
tools=tools
)
# 4. Taispeáin an freagra deiridh
print(final_response.choices[0].message.content)
# → "Payment T1001 status is: paid."
Níl comhréiteach ar ord na n-oibríochtaí append dhá uair: ní mór don teachtaireacht chúntóra a iompraíonn an tool_call teacht roimh an teachtaireacht tool a fhreagraíonn di. Má mhalartaíonn tú iad, cruthaítear stair neamhréireach a dhiúltaíonn an API.
An Sreabha Iomlán i mBloc Amháin
Seo an próiseas iomlán, ó cheist an úsáideora go dtí an freagra deiridh:
import os
import json
from mistralai.client import Mistral
from functools import partial
# Cumraíocht
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
model = "mistral-large-latest"
# Feidhmeanna agus uirlisí (sainithe cheana)
available_functions = {
"retrieve_payment_status": partial(retrieve_payment_status, df),
"retrieve_payment_date": partial(retrieve_payment_date, df),
}
# Céimeanna 1-2: Ceist an úsáideora + Glao API
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
response = client.chat.complete(
model=model, messages=messages, tools=tools
)
# Céimeanna 3-4: Bain an tool_call amach agus feidhmigh é
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)
# Feidhmiú ar thaobh an chliaint
result = available_functions[function_name](**function_params)
# Céim 5: Seol an toradh ar ais chuig an tsamhail
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)
Struchtúr na dTeachtaireachtaí ag Gach Céim
Fiú an liosta messages a scrúdú nuair a bheidh an timthriall críochnaithe, toisc gurb é an bealach is fearr é chun glaonna feidhme atá ag mí-iompar a dhífhabhtú. Tá ceithre theachtaireacht ann.
# Teachtaireacht 1: Ceist an úsáideora
{"role": "user", "content": "What is the status of payment T1001?"}
# Teachtaireacht 2: Freagra na samhla leis an tool_call
{"role": "assistant", "tool_calls": [{"id": "call_abc123", ...}]}
# Teachtaireacht 3: Toradh na feidhme
{"role": "tool", "name": "retrieve_payment_status",
"content": '{"status": "paid"}', "tool_call_id": "call_abc123"}
# Teachtaireacht 4 (implíoch): Freagra deiridh na samhla
# → "Payment T1001 status is: paid."
Lean an t-ID call_abc123: rugadh é i dTeachtaireacht 2 agus feictear arís é i dTeachtaireacht 3. Nascann an snáithe sin an t-iarratas lena fhreagra. Is é an struchtúr seo an patrún bunúsach de ghlaonna feidhme; déanann gach leagan amach a thagann tú air ina dhiaidh sin, cibé an il-chasadh nó comhthreomhar é, é a athrá nó a dhúbailt.
Bí Airdeallach ar Fhormáid an Chontaint
Tá earráid amháin le feiceáil níos minice ná gach ceann eile, agus baineann sí le cineál an réimse content: ní mór gur teaghrán é i gcónaí.
# Ceart — Teaghrán JSON
{"content": '{"status": "paid"}'}
# Ceart — Gnáth-théacs
{"content": "The status is paid"}
# Mícheart — Foclóir Python (cuirfidh sé earráid faoi deara)
{"content": {"status": "paid"}}
Is sna comharthaí luachana timpeall an JSON atá an difríocht idir an chéad sampla agus an tríú sampla. Má thugann do fheidhm foclóir ar ais, tiontaigh é le json.dumps() sula seolann tú é—sin díreach an fáth a raibh json.dumps() ag deireadh gach feidhme i gCeacht 4.
Príomhphointí
- Tarlaíonn feidhmiú na feidhme ar thaobh an chliaint, i do chód féin—ní dhéanann an tsamhail é riamh
- Seoltar an toradh ar ais i dteachtaireacht leis an ról
"tool"agus antool_call_idcomhfhreagrach - Ní mór gur teaghrán é
contentna teachtaireachta uirlise (teaghrán JSON) - Tar éis duit an toradh a sheoladh, glaoidh tú ar
chat.complete()arís ionas gur féidir leis an tsamhail an freagra deiridh a fhoirmiú - Seiceáil i gcónaí go bhfuil an fheidhm a iarradh i do fhoclóir seolta