Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Proces u 5 koraka

Lekcija 2 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Jasan protokol između tebe i modela
  2. Tijek rada u detalje
  3. Obrasci tijeka rada
  4. Ključne točke

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.

1

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.

2

Korisnik postavlja pitanje (Korisnik)

Korisnik postavlja svoje pitanje na prirodnom jeziku. Ti šalješ ovaj zahtjev Mistral modelu zajedno s popisom dostupnih alata.

3

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.

4

Izvrši funkciju (Programer)

Tvoj kod izvlači naziv funkcije i argumente iz odgovora modela, pokreće odgovarajuću funkciju i dohvaća rezultat.

5

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)