Rollid: system, developer, user ja assistant
Sellel lehel
Neli sõnumirolli
Iga vestluse lõpuleviimise (Chat Completions) lõpppunkti saadetud sõnum sisaldab välja role, mis määrab, kuidas Groki mudel seda tõlgendab. Nende rollide mõistmine on hädavajalik vestluste struktureerimiseks ja kvaliteetsete vastuste saamiseks.
xAI API tunneb ära neli rolli: system, developer, user ja assistant. Igal neist on sõnumite massiivis kindel koht ja kasutusviis.
Rollid system (või developer)
Sõnum system asub sõnumite massiivis esimesena. See määrab mudeli üldise käitumise kogu vestluse vältel: tooni, vastuse vormingu, piirangud, isiksuse, keele ja muu.
{
"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."
}
Roll developer on rolli system alias. Need kaks on xAI API-s omavahel asendatavad. OpenAI tutvustas rolli developer, et paremini kajastada selle eesmärki: need on arendaja juhised, mitte „süsteemi“ omad.
Parimad tavad süsteemsõnumi jaoks
- Ole konkreetne: „Vasta maksimaalselt 3 lauses“ on tõhusam kui „Ole lakooniline“.
- Määra vorming: täpsusta, kas ootad JSON-i, Markdowni või loetelu.
- Sea piirangud: näita ära, mida mudel ei tohi teha.
- Anna kontekst: lisa äriline kontekst („Oled veterinaarkliiniku assistent“).
Roll user
Sõnumid user esindavad lõppkasutaja sisendit. Need on küsimused, päringud või juhised, mida sinu rakendusega suhtlev isik saadab.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Sõnum user võib vestluses ilmuda ükskõik kus pärast süsteemsõnumit. Mitme vooruga vestluses vahelduvad tavaliselt sõnumid user ja assistant.
Roll assistant
Sõnumid assistant esindavad mudeli eelmisi vastuseid. Kui saadad tagasi vestlusajaloo, on iga Groki vastus märgistatud selle rolliga.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Saad kasutada rolli assistant ka näidispromptimiseks (few-shot prompting): sisestades soovitud vastuste näited enne tegelikku kasutaja sõnumit.
{
"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."}
]
}
Selles näites toimivad kaks esimest kasutaja ja assistendi vahetust demonstratsioonina. Mudel mõistab oodatavat vormingut ja rakendab sama loogikat kolmandale sõnumile.
Täielik päringu struktuur
Siin on tüüpiline päring, mis ühendab kõiki kolme rolli mitme vooruga vestluses:
{
"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."
}
]
}
Järjekord on alati sama: esmalt system, seejärel vaheldumisi user ja assistant, kusjuures viimane sõnum peab tingimata olema user (see on küsimus, millele mudel peab vastama).
Peamised punktid
- system/developer: arendaja juhised, alati esimesena, määrab üldise käitumise
- user: lõppkasutaja sõnumid, käivitavad vastuse genereerimise
- assistant: mudeli eelmised vastused, kasulikud ajaloo ja näidispromptimise jaoks
- Rollid
systemjadeveloperon xAI API-s omavahel asendatavad - Massiivi viimane sõnum peab olema
user