Uloge: system, developer, user i assistant
Na ovoj stranici
Četiri uloge poruka
Svaka poruka poslana na krajnju točku Chat Completions uključuje polje role koje određuje kako model Grok tumači tu poruku. Razumijevanje ovih uloga ključno je za strukturiranje razgovora i dobivanje kvalitetnih odgovora.
xAI API prepoznaje četiri uloge: system, developer, user i assistant. Svaka ima specifično mjesto i namjenu unutar polja messages.
Uloga system (ili developer)
Poruka system dolazi prva u polju messages. Ona definira opće ponašanje modela za cijeli razgovor: ton, format odgovora, ograničenja, osobnost, jezik i slično.
{
"role": "system",
"content": "You are a cybersecurity expert. Always respond in English, concisely and technically. If you do not know the answer, state it clearly."
}
Uloga developer alias je za system. Te su dvije uloge zamjenjive u xAI API-ju. OpenAI je uveo developer kako bi bolje odrazio namjeru: radi se o uputama programera, a ne „sustava“.
Najbolje prakse za poruku system
- Budi specifičan: „Odgovori u najviše 3 rečenice“ učinkovitije je od „Budi sažet“
- Definiraj format: navedi očekuješ li JSON, Markdown ili nabrajanje
- Postavi ograničenja: naznači što model ne smije raditi
- Osiguraj kontekst: daj poslovni kontekst („Ti si asistent za veterinarsku kliniku“)
Uloga user
Poruke user predstavljaju unos krajnjeg korisnika. To su pitanja, zahtjevi ili upute koje šalje osoba koja interagira s tvojom aplikacijom.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Poruka user može se pojaviti bilo gdje u razgovoru nakon poruke system. U razgovoru s više izmjena obično izmjenjuješ poruke user i assistant.
Uloga assistant
Poruke assistant predstavljaju prethodne odgovore modela. Kada šalješ povijest razgovora, svaki odgovor od Groka označen je ovom ulogom.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Ulogu assistant možeš koristiti i za few-shot prompting: ubacivanje primjera željenih odgovora prije stvarne poruke korisnika.
{
"messages": [
{"role": "system", "content": "Classify the sentiment: positive, negative, or neutral."},
{"role": "user", "content": "I love this product!"},
{"role": "assistant", "content": "positive"},
{"role": "user", "content": "Customer service is deplorable."},
{"role": "assistant", "content": "negative"},
{"role": "user", "content": "The delivery arrived yesterday."}
]
}
U ovom primjeru prve dvije izmjene user/assistant služe kao demonstracija. Model razumije očekivani format i primijenit će istu logiku na treću poruku.
Potpuna struktura zahtjeva
Evo tipičnog zahtjeva koji kombinira sve tri uloge u razgovoru s više izmjena:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{
"role": "system",
"content": "You are a teaching assistant specialized in mathematics. Explain concepts step by step."
},
{
"role": "user",
"content": "What is a derivative?"
},
{
"role": "assistant",
"content": "A derivative measures the instantaneous rate of change of a function..."
},
{
"role": "user",
"content": "Give me a concrete example."
}
]
}
Redoslijed je uvijek isti: prvo system, zatim izmjenično user/assistant, pri čemu zadnja poruka obavezno mora biti user (to je pitanje na koje model mora odgovoriti).
Ključne točke
- system/developer: upute programera, uvijek prve, definiraju opće ponašanje
- user: poruke krajnjeg korisnika, pokreću generiranje odgovora
- assistant: prethodni odgovori modela, korisni za povijest i few-shot prompting
- Uloge
systemideveloperzamjenjive su u xAI API-ju - Zadnja poruka u polju mora biti poruka
user