Proces v 5 krokoch
Jasný protokol medzi tebou a modelom
Volanie funkcií v Mistrale sa riadi presne definovaným procesom piatich krokov. Čo robí tento protokol čitateľným, je fakt, že každý krok má jediného vlastníka: buď ty (vývojár), model, alebo používateľ. Žiadny krok nie je zdieľaný a žiadny nie je nejednoznačný. Venuj čas zapamätaniu si tohto rozdelenia práce ešte pred napísaním prvého riadku kódu: väčšina chýb pri volaní funkcií vzniká vtedy, keď vývojár očakáva, že krok vybaví model, hoci v skutočnosti patrí do jeho zodpovednosti.
Definuj funkcie (Vývojár)
Každú dostupnú funkciu popíšeš pomocou schémy JSON: názov, popis, parametre, typy a povinné polia. Model vidí iba túto špecifikáciu, nie tvoj kód.
Používateľ položí otázku (Používateľ)
Používateľ položí svoju otázku v prirodzenom jazyku. Túto požiadavku spolu so zoznamom dostupných nástrojov odošleš modelu Mistral.
Generuj argumenty (Model)
Model analyzuje požiadavku, vyberie vhodnú funkciu a vygeneruje argumenty vo formáte JSON. Funkciu nevykonáva – iba ti povie, čo máš zavolať a s akými parametrami.
Vykonaj funkciu (Vývojár)
Tvoj kód extrahuje názov funkcie a argumenty z odpovede modelu, spustí zodpovedajúcu funkciu a získa výsledok.
Vygeneruj konečnú odpoveď (Model)
Výsledok funkcie odošleš späť modelu. Ten ho integruje do kontextu konverzácie a sformuluje prirodzenú odpoveď pre používateľa.
Tok v detailoch
Týchto päť krokov sa priamo mapuje do kódu. Prejdime si ich na jednom zámerne minimálnom príklade: používateľ chce zistiť stav platby T1001. Tento istý príklad použijeme ako červenú niť až do konca bloku „Implementácia v Pythone“, takže si teraz zapamätaj jeho identifikátory.
Krok 1: Definuješ nástroje
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"]
}
}
}
]
Nič z toho nie je vykonateľný kód: je to iba opis. Model sa dozvie, že existuje funkcia s názvom get_payment_status, čo robí a že vyžaduje transaction_id typu reťazec. Nikdy sa nedozvie, ako je funkcia implementovaná.
Krok 2: Používateľ položí svoju otázku
messages = [
{"role": "user", "content": "What is the status of payment T1001?"}
]
Krok 3: Model vygeneruje argumenty
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 extrahoval „T1001“ z vety a umiestnil ho do správneho poľa. Všimni si, že arguments prichádzajú ako reťazec, nie ako slovník: tento detail vybavíš v ďalšom kroku.
Krok 4: Vykonáš funkciu
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"}
Krok 5: Model sformuluje odpoveď
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."
Do histórie sa pridávajú dve správy, nikdy nie len jedna: správa asistenta nesúca požiadavku na volanie, po ktorej nasleduje správa nesúca výsledok. tool_call_id tieto dve správy spája. Ak vynecháš ktorúkoľvek z nich, API požiadavku odmietne alebo model odpovie mimo tému.
Vzorce toku
V závislosti od zložitosti požiadavky môže tento tok nadobúdať rôzne formy. Najjednoduchší prípad nastáva, keď nie je zapojená žiadna funkcia: používateľ položí všeobecnú otázku – „Čo vieš robiť?“ – a model odpovie priamo, bez toho, aby sa vôbec dotkol nástrojov. Ďalej nasleduje jednoduché volanie, ktoré sme práve prešli: jedna funkcia, jeden výsledok, jedna odpoveď.
Ďalšie dve formy sú zaujímavejšie. Pri sekvenčnom reťazci model zavolá prvú funkciu, prečíta si výsledok a použije ho na rozhodnutie o druhom volaní – typicky získava ID zákazníka pred dotazom na jeho faktúry. Pri paralelnom volaní požaduje vykonanie viacerých funkcií naraz, pretože žiadna z nich nie je závislá od druhej. Týmto dvom vzorcom venujeme celé lekcie; zatiaľ si zapamätaj, že obe sa spoliehajú presne na vyššie uvedených päť krokov, ktoré sa jednoducho opakujú.
Kľúčové poznatky
- Volanie funkcií sa riadi procesom v 5 krokoch s jasne definovanými zodpovednosťami
- Model nikdy nemôže priamo vykonať funkciu – iba generuje argumenty
- Tvoj kód je strážcom brány: rozhoduje, či sa funkcia vykoná, alebo nie
- Výsledok funkcie sa odošle späť modelu, aby mohol sformulovať prirodzenú odpoveď
- Tok môže byť jednoduchý (jedno volanie) alebo zložitý (sekvenčný, paralelný)