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

Uloge i poruke

Lekcija 2 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Srž konverzacijskog protokola
  2. Četiri uloge
  3. Potpuna struktura višekružne razmjene
  4. Strukturirani sadržaj
  5. Zastavica prefiksa (Prefix Flag)
  6. Ključne točke

Srž konverzacijskog protokola

Chat Completions API ne prihvaća sirovi tekst. Očekuje niz strukturiranih poruka, od kojih svaka ima dodijeljenu specifičnu ulogu. Taj sustav uloga omogućuje modelu da razlikuje tko govori, koji je kontekst i kako treba odgovoriti. Isti tekst – „Uvijek odgovaraj u JSON formatu“ – ima različitu težinu ovisno o tome stiže li kao instrukcija developera ili kao korisnički unos. Savladavanje ove strukture ono je što razlikuje koherentnog chatbota od sustava koji skreće s teme nakon tri razmjene.

Četiri uloge

Mistralov API prepoznaje četiri različite uloge, od kojih svaka ima preciznu funkciju u razgovoru.

Uloga system

Sistemska poruka definira opće ponašanje modela. Postavlja se na prvo mjesto i čita se prije bilo kakve razmjene. Ovdje postavljaš ton, ograničenja i kontekst za svoju aplikaciju. Zamisli asistenta dizajniranog za odvjetnički ured; sistemska poruka ekvivalentna je bilješci s uputama koju bi predao novom suradniku prije njegovog prvog predmeta.

messages = [
    {
        "role": "system",
        "content": "You are a legal assistant specializing in French law. "
                   "Respond precisely and cite relevant legal articles. "
                   "If you are unsure, state it explicitly."
    }
]

Ovom porukom upravlja developer, nikad krajnji korisnik, i ona se nikada ne prikazuje u sučelju tvoje aplikacije.

Uloga user

Slijedi poruka ljudskog korisnika: pitanje, instrukcija ili tekst za obradu. Ovo je jedini dio razgovora kojim tvoji korisnici izravno upravljaju.

messages.append({
    "role": "user",
    "content": "What are the statutes of limitations in civil law?"
})

Uloga assistant

Ova uloga sadrži prethodne odgovore modela. Postaje ključna čim razgovor prijeđe jedan krug. Bez nje, korisnik koji pita „Što je s komercijalnim dugovima?“ dobio bi odgovor izvan teme jer model ne bi znao o čemu se raspravlja.

messages.append({
    "role": "assistant",
    "content": "In French civil law, the standard statute of limitations is 5 years..."
})

Uloga tool

Posljednja uloga stupa na snagu tijekom pozivanja funkcija. Kada model zatraži izvršenje vanjske funkcije – na primjer, upit vremenskom API-ju – ti tu funkciju pokrećeš na svojoj strani i vraćaš rezultat pod ovom ulogom, referencirajući ID specifičnog poziva:

messages.append({
    "role": "tool",
    "content": '{"temperature": 22, "city": "Paris"}',
    "tool_call_id": "call_abc123"
})

Potpuna struktura višekružne razmjene

Pogledajmo ove uloge na djelu u stvarnom razgovoru gdje korisnik prilagođava svoj zahtjev nakon početnog odgovora:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

conversation = [
    {
        "role": "system",
        "content": "You are a French chef. Propose simple and tasty recipes."
    },
    {
        "role": "user",
        "content": "I want to make a dessert with apples."
    }
]

# First turn
response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

assistant_reply = response.choices[0].message.content
print(assistant_reply)

# Add response to history
conversation.append({"role": "assistant", "content": assistant_reply})

# Second turn
conversation.append({
    "role": "user",
    "content": "Can you adapt this recipe for 8 people?"
})

response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

print(response.choices[0].message.content)

Primijeti što ovaj kod zapravo radi: u svakom krugu šalje natrag cijelu povijest. Model nema trajno pamćenje između zahtjeva. „Ovaj recept“ ima smisla samo zato što je prethodni odgovor još uvijek u nizu. Ti si u potpunosti odgovoran za upravljanje stanjem razgovora.

Strukturirani sadržaj

Polje content prihvaća dva oblika. Najčešći je jednostavni niz znakova. No, čim prenosiš nešto drugo osim teksta – na primjer, sliku za opisivanje – prelaziš na popis tipiziranih blokova:

# Simple content (text)
{"role": "user", "content": "Describe this image."}

# Structured content (multimodal)
{"role": "user", "content": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

Zastavica prefiksa (Prefix Flag)

Mistral nudi jedinstvenu značajku: zastavicu prefiksa. Sam napišeš početak odgovora asistenta, a model je prisiljen nastaviti od tog mjesta. Ovo je iznimno učinkovito kada trebaš parsirati izlaz s nultom marginom za grešku.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "system", "content": "You always respond in JSON."},
        {"role": "user", "content": "List 3 European capitals."},
        {"role": "assistant", "content": '{"capitals": [', "prefix": True}
    ]
)

Model nastavlja generiranje nakon {"capitals": [, čime se odmah eliminira rizik od pojavljivanja teksta „Naravno, evo vašeg JSON-a:“ prije otvarajuće vitičaste zagrade. U proizvodnji je ovo jamstvo formata često vrijednije od instrukcije ponovljene tri puta u sistemskoj poruci.

Usvoji dvije navike odmah. Drži sistemsku poruku sažetom: jedan dobro napisan odlomak daje bolje rezultate od dvije stranice pravila, od kojih će model na kraju dio ignorirati. I nikada ne izmišljaj lažne odgovore asistenta kako bi usmjerio model, s jednom iznimkom – učenje s nekoliko primjera (few-shot learning), koje ćemo obraditi u Lekciji 10. Za duge razgovore šalji cijelu povijest, ali prati prozor konteksta i ukloni najstarije krugove prije nego što ga prijeđeš.

Ključne točke

  • Četiri uloge: system (ponašanje), user (zahtjev), assistant (odgovor), tool (rezultat funkcije)
  • Sistemska poruka ide prva i definira okvir aplikacije
  • Model nema memoriju: s svakim zahtjevom pošalji cijelu povijest
  • Zastavica prefiksa prisiljava početak odgovora kako bi se kontrolirao format izlaza