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

Uloge: System, User i Assistant

Lekcija 2 od 16 Ažurirano 2. studenoga 2026. Početnik
Na ovoj stranici
  1. Razumijevanje sustava uloga
  2. Uloga system: temelj tvog prompta
  3. Uloga user: konkretan zahtjev
  4. Uloga assistant: vođenje odgovora
  5. Uloga tool: rezultati funkcija
  6. Izgradnja potpunog razgovora
  7. Ključne točke

Razumijevanje sustava uloga

Mistralov API za Chat Completions strukturira svaki razgovor oko uloga dodijeljenih porukama. Svaka poruka poslana modelu mora uključivati ulogu koja definira njezinu funkciju u razmjeni: tko govori i s kojim ovlastima. Ovaj mehanizam može djelovati kao tehnički detalj, no zapravo je okosnica svakog profesionalnog prompta – upravo on razlikuje jednostavno pitanje postavljeno u chatu od pažljivo izgrađene aplikacije.

Mistral prepoznaje četiri različite uloge, od kojih svaka ima preciznu funkciju:

Uloga Opis Primjer
system Definira osobnost, ponašanje i opći kontekst modela "Ti si francuski pravni stručnjak specijaliziran za radno pravo."
user Sadrži korisnikov zahtjev ili uputu "Koje su obveze poslodavca u slučaju gospodarskog otkaza?"
assistant Predstavlja odgovore modela ili vam omogućuje unaprijed popunjavanje početka odgovora "Evo 5 glavnih obveza: 1. ..."
tool Vraća rezultat poziva funkcije (function calling) JSON rezultat iz pretraživanja baze podataka

Uloga system: temelj tvog prompta

Poruka system dolazi prva na popisu poruka i djeluje kao trajna direktiva koja utječe na cijeli razgovor. Zamisli je kao opis posla koji bi uručio novom članu tima prije prvog radnog dana: definira očekivanu osobnost (ton, razinu formalnosti, jezik), preferirano područje stručnosti, pravila o tome što model smije, a što ne smije raditi, te zadani format za njegove odgovore. Jednom kada je taj opis napisan, svaka sljedeća razmjena odvija se unutar tog okvira bez potrebe da ga ponavljaš.

messages = [
    {
        "role": "system",
        "content": """Ti si iskusni tehnički pisac specijaliziran za API dokumentaciju.
Pravila:
- Koristi precizan tehnički engleski jezik
- Uvijek uključi primjere Python koda
- Strukturiraj svoje odgovore naslovima i popisima
- Nikada ne prijeđi 500 riječi po odgovoru"""
    },
    {
        "role": "user",
        "content": "Objasni kako rukovati HTTP pogreškama u REST API-ju."
    }
]

Zapamti važnu točku za svoje buduće aplikacije: prompt za system upravlja programer, a ne krajnji korisnik. Korisnik tvoje aplikacije nikada ga ne vidi, no sve njegove interakcije odvijaju se unutar okvira koji si tamo uspostavio. To ga čini tvojim najmoćnijim polugom kontrole.

Uloga user: konkretan zahtjev

Poruka user sadrži specifičan zahtjev. Ovo je najintuitivnija uloga: predstavlja ono što čovjek kaže modelu, a svako novo pitanje ili uputa od korisnika postaje poruka s ulogom user. Njezina prividna jednostavnost ne smije te navesti da zaboraviš najbolje prakse: budi precizan u svom zahtjevu, navedi željeni format ako se razlikuje od onog definiranog u promptu za system i izravno u poruku uključi podatke koje modelu trebaju – tekst za sažimanje, brojke za analizu. Model ne može dohvatiti ono što mu ne daš.

Uloga assistant: vođenje odgovora

Uloga assistant najsuptilnija je od ove tri jer ima dvije različite namjene. Prva je povijest razgovora: u razmjeni s više okretaja, prethodni odgovori modela ponovno se umeću s ulogom assistant kako bi se održao kontekst. Tako model „pamti“ što je rekao:

messages = [
    {"role": "user", "content": "Koji je glavni grad Francuske?"},
    {"role": "assistant", "content": "Glavni grad Francuske je Pariz."},
    {"role": "user", "content": "A njegovo stanovništvo?"}
]

Bez međuporuke assistant, zamjenica „njegovo“ u posljednjem pitanju ne bi se na što odnosila: API je bez stanja (stateless), a memoriju rekonstruiraš pri svakom pozivu.

Druga namjena je unaprijed popunjavanje (prefix): svoj popis poruka možeš završiti porukom assistant koja sadrži početak očekivanog odgovora. Model će nastaviti od te točke, kao da su prve riječi već izašle iz njegovih usta. Ovo je moćna tehnika za kontrolu formata izlaza:

messages = [
    {"role": "user", "content": "Navedi 3 Python frameworka za web."},
    {"role": "assistant", "content": "```json\n[", "prefix": True}
]

Obrati pažnju na polje "prefix": True: Mistralov API zahtijeva ga na ovoj posljednjoj poruci assistant kako bi je tretirao kao početak odgovora.

Ovdje model shvaća da piše JSON i dovršit će započeti niz, bez uvoda ili uvodne rečenice. Ondje gdje bi tekstualna uputa „odgovori u JSON-u“ mogla biti ignorirana, već napisan početak odgovora ne ostavlja mnogo izbora.

Uloga tool: rezultati funkcija

Uloga tool stupa na snagu tijekom pozivanja funkcija (function calling). Kada model odluči pozvati vanjsku funkciju – pretraživanje weba, zahtjev API-ju, izračun – rezultat te funkcije šalje se natrag kao poruka tool, koju model zatim integrira u svoj odgovor. Ova je uloga naprednija i bit će obrađena u posebnim tečajevima; samo zapamti da postoji i nadopunjuje glavni trio.

Izgradnja potpunog razgovora

Sada sastavimo sve ove elemente u realističnu razmjenu, gdje prompt za system okviruje assistant, gdje povijest održava nit, a gdje se posljednje pitanje prirodno nadovezuje na ono što je prethodilo:

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "Ti si francuski kulinarski asistent. Odgovaraj sažeto."
        },
        {
            "role": "user",
            "content": "Kako napraviti klasičnu vinaigrette?"
        },
        {
            "role": "assistant",
            "content": "Za klasičnu vinaigrette pomiješaj 1 žlicu senfa, 3 žlice maslinovog ulja i 1 žlicu octa."
        },
        {
            "role": "user",
            "content": "A za lakšu verziju?"
        }
    ]
)

Promotri arhitekturu: prvo system, zatim izmjena user/assistant koja reproducira tijek razgovora. Ovaj redoslijed nije dekorativan – on modelu omogućuje da ispravno protumači „lakšu verziju“ kao varijantu vinaigrettea o kojem je upravo raspravljao.

Ključne točke

  • Uloga system okviruje opće ponašanje modela – to je tvoja najmoćnija poluga
  • Uloga user prenosi konkretan korisnikov zahtjev
  • Uloga assistant služi i kao povijest i kao vodič za format odgovora
  • Uloga tool rukuje rezultatima poziva funkcija
  • Redoslijed poruka ključan je: prvo system, zatim izmjena user/assistant