Uloge: System, User i Assistant
Na ovoj stranici
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