Procesas iš 5 žingsnių
Šiame puslapyje
Aiškus protokolas tarp tavęs ir modelio
„Mistral“ funkcijų kvietimas laikosi gerai apibrėžto penkių žingsnių proceso. Šį protokolą lengva suprasti todėl, kad kiekvienas žingsnis turi tik vieną atsakingąją šalį: arba tu (kūrėjas), arba modelis, arba naudotojas. Joks žingsnis nėra bendras ir joks nėra dviprasmiškas. Skirk laiko įsiminti šį darbų pasiskirstymą prieš rašydamas bent vieną kodo eilutę: dauguma funkcijų kvietimo klaidų kyla tada, kai kūrėjas tikisi, jog modelis atliks žingsnį, kuris iš tikrųjų yra jo paties atsakomybė.
Apibrėžk funkcijas (Kūrėjas)
Tu aprašai kiekvieną prieinamą funkciją naudodamas JSON schemą: pavadinimą, aprašymą, parametrus, tipus ir privalomus laukus. Modelis mato tik šią specifikaciją, o ne tavo kodą.
Naudotojas užduoda klausimą (Naudotojas)
Naudotojas užduoda savo klausimą natūralia kalba. Tu siunči šį užklausimą „Mistral“ modeliui kartu su prieinamų įrankių sąrašu.
Sugeneruok argumentus (Modelis)
Modelis išanalizuoja užklausą, pasirenka tinkamą funkciją ir sugeneruoja argumentus JSON formatu. Jis nevykdo funkcijos – jis tiesiog tau pasako, ką reikia iškviesti ir su kuriais parametrais.
Įvykdyk funkciją (Kūrėjas)
Tavo kodas iš modelio atsakymo ištraukia funkcijos pavadinimą ir argumentus, paleidžia atitinkamą funkciją ir gauna rezultatą.
Sugeneruok galutinį atsakymą (Modelis)
Tu siunči funkcijos rezultatą atgal modeliui. Jis integruoja rezultatą į pokalbio kontekstą ir suformuluoja natūralų atsakymą naudotojui.
Eiga išsamiai
Šie penki žingsniai tiesiogiai atitinka kodą. Panagrinėkime juos naudodami vieną, tyčia minimalų pavyzdį: naudotojas nori sužinoti mokėjimo T1001 būseną. Naudosime šį patį pavyzdį kaip raudoną siūlą iki pat skyriaus „Python implementacija“ pabaigos, todėl jau dabar įsimink jo identifikatorius.
1 žingsnis: Tu apibrėži įrankius
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"]
}
}
}
]
Čia nėra jokio vykdomojo kodo: tai tik aprašymas. Modelis sužino, kad egzistuoja funkcija pavadinimu get_payment_status, ką ji daro ir kad jai reikia transaction_id (eilutės tipo) argumento. Jis niekada nesužino, kaip funkcija yra implementuota.
2 žingsnis: Naudotojas užduoda savo klausimą
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
3 žingsnis: Modelis sugeneruoja argumentus
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"}'
Modelis ištraukė „T1001“ iš sakinio ir įdėjo jį į tinkamą lauką. Atkreipk dėmesį, kad arguments atkeliauja kaip eilutė, o ne kaip žodynas: šią detalę tvarkysi kitame žingsnyje.
4 žingsnis: Tu įvykdai funkciją
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"}
5 žingsnis: Modelis suformuluoja atsakymą
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."
Į istoriją įtraukiami du pranešimai, niekada tik vienas: asistento pranešimas, kuriame yra kvietimo užklausa, ir po jo einantis pranešimas su rezultatu. Juos susieja tool_call_id. Praleisk bent vieną iš jų ir API atmes užklausą, arba modelis atsakys ne į temą.
Eigos šablonai
Priklausomai nuo užklausos sudėtingumo, ši eiga gali įgyti skirtingas formas. Paprasčiausias atvejis – kai funkcijos nenaudojamos: naudotojas užduoda bendrą klausimą („Ką tu moki?“) ir modelis atsako tiesiogiai, nė karto nepasinaudodamas įrankiais. Kitas atvejis – tai paprastas kvietimas, kurį ką tik nagrinėjome: viena funkcija, vienas rezultatas, vienas atsakymas.
Kitos dvi formos yra įdomesnės. Nuoseklioje grandinėje modelis iškviečia pirmąją funkciją, perskaito rezultatą ir panaudoja jį nuspręsdamas dėl antrojo kvietimo – pavyzdžiui, pirmiausia gauna kliento ID, o tada užklausia jo sąskaitas. Lygiagrečiojo kvietimo atveju jis vienu metu prašo įvykdyti kelias funkcijas, nes nė viena iš jų nepriklauso nuo kitos. Šiems dviem šablonams skirsime atskiras pamokas; kol kas tiesiog įsimink, kad abu jie remiasi tais pačiais penkiais aukščiau aprašytais žingsniais, kurie tiesiog kartojami.
Svarbiausi punktai
- Funkcijų kvietimas laikosi 5 žingsnių proceso su aiškiomis atsakomybėmis
- Modelis niekada negali tiesiogiai įvykdyti funkcijos – jis tik sugeneruoja argumentus
- Tavo kodas yra vartininkas: jis sprendžia, ar vykdyti funkciją, ar ne
- Funkcijos rezultatas siunčiamas atgal modeliui, kad jis galėtų suformuluoti natūralų atsakymą
- Eiga gali būti paprasta (vienas kvietimas) arba sudėtinga (nuosekli, lygiagreti)