Proces u 5 koraka
Na ovoj stranici
Jasan protokol između tebe i modela
Mistralovo pozivanje funkcija slijedi dobro definiran proces od pet koraka. Ono što ovaj protokol čini čitljivim jest činjenica da svaki korak ima samo jednog vlasnika: ili ti (programer), model ili korisnik. Nijedan korak nije zajednički i nijedan nije dvosmislen. Odvoji vrijeme da zapamtiš ovu podjelu rada prije nego napišeš ijednu liniju koda: većina grešaka pri pozivanju funkcija događa se kada programer očekuje da će model obaviti korak koji je zapravo njegova odgovornost.
Definiraj funkcije (Programer)
Opisuješ svaku dostupnu funkciju pomoću JSON sheme: naziv, opis, parametri, tipovi i obavezna polja. Model vidi samo ovu specifikaciju, a ne tvoj kod.
Korisnik postavlja pitanje (Korisnik)
Korisnik postavlja svoje pitanje na prirodnom jeziku. Ti šalješ ovaj zahtjev Mistral modelu zajedno s popisom dostupnih alata.
Generiraj argumente (Model)
Model analizira zahtjev, odabire odgovarajuću funkciju i generira argumente u JSON formatu. On ne izvršava funkciju – samo ti govori što trebaš pozvati i s kojim parametrima.
Izvrši funkciju (Programer)
Tvoj kod izvlači naziv funkcije i argumente iz odgovora modela, pokreće odgovarajuću funkciju i dohvaća rezultat.
Generiraj konačni odgovor (Model)
Šalješ rezultat funkcije natrag modelu. On integrira rezultat u kontekst razgovora i formulira prirodan odgovor za korisnika.
Tijek rada u detalje
Ovih pet koraka izravno se preslikava u kod. Prođimo kroz njih koristeći jedan namjerno minimalan primjer: korisnik želi znati status plaćanja T1001. Koristit ćemo ovaj isti primjer kao nit vodilju do kraja bloka „Implementacija u Pythonu“, pa se sada upoznaj s njegovim identifikatorima.
Korak 1: Ti definiraš alate
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"]
}
}
}
]
Ovdje nema izvršnog koda: ovo je opis. Model saznaje da funkcija pod nazivom get_payment_status postoji, što radi i da zahtijeva transaction_id tipa string. Nikada ne saznaje kako je funkcija implementirana.
Korak 2: Korisnik postavlja svoje pitanje
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
Korak 3: Model generira argumente
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"}'
Model je izvukao „T1001“ iz rečenice i stavio ga u ispravno polje. Imaj na umu da arguments stiže kao string, a ne kao rječnik: tu ćeš pojedinost obraditi u sljedećem koraku.
Korak 4: Ti izvršavaš funkciju
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"}
Korak 5: Model formulira odgovor
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."
U povijest se dodaju dvije poruke, nikada samo jedna: poruka asistenta koja nosi zahtjev za poziv, praćena porukom koja nosi rezultat. tool_call_id povezuje te dvije poruke. Izbaciš li bilo koju od njih, API će odbiti zahtjev ili će model odgovoriti izvan teme.
Obrasci tijeka rada
Ovisno o složenosti zahtjeva, ovaj tijek može poprimiti različite oblike. Najjednostavniji slučaj je kada funkcija nije uključena: korisnik postavi opće pitanje – „Što možeš učiniti?“ – a model odgovori izravno, nikada ne dotaknuvši alate. Zatim slijedi jednostavan poziv koji smo upravo prošli: jedna funkcija, jedan rezultat, jedan odgovor.
Sljedeća dva oblika su zanimljivija. U sekvencijalnom lancu model poziva prvu funkciju, čita rezultat i koristi ga za donošenje odluke o drugom pozivu – tipično dohvaćanje ID-a kupca prije upita za njihove račune. U paralelnom pozivu traži izvršenje više funkcija odjednom jer nijedna ne ovisi o drugoj. Cijele ćemo lekcije posvetiti ova dva obrasca; za sada zapamti da se oba oslanjaju na točno istih pet gore navedenih koraka, samo ponovljenih.
Ključne točke
- Pozivanje funkcija slijedi proces od 5 koraka s jasnim odgovornostima
- Model nikada ne može izravno izvršiti funkciju – on samo generira argumente
- Tvoj kod je čuvar vrata: on odlučuje hoće li se funkcija izvršiti ili ne
- Rezultat funkcije šalje se natrag modelu kako bi mogao formulirati prirodan odgovor
- Tijek rada može biti jednostavan (jedan poziv) ili složen (sekvencijalan, paralelan)