Vloge: system, developer, user in assistant
Na tej strani
Štiri vloge sporočil
Vsako sporočilo, poslano končni točki Chat Completions, vključuje polje role, ki določa, kako model Grok razume njegovo vsebino. Razumevanje teh vlog je ključno za pravilno strukturiranje pogovorov in pridobivanje kakovostnih odgovorov.
API xAI prepozna štiri vloge: system, developer, user in assistant. Vsaka ima v polju messages določen položaj in namen uporabe.
Vloga system (ali developer)
Sporočilo system je vedno prvo v polju messages. Določa splošno obnašanje modela za celoten pogovor: ton, format odgovora, omejitve, osebnost, jezik in podobno.
{
"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."
}
Vloga developer je sopomenka za system. V API-ju xAI sta medsebojno zamenljivi. OpenAI je uvedel vlogo developer, da bi bolje odražal namen: gre za navodila razvijalca, ne pa „sistema”.
Najboljše prakse za sporočilo system
- Bodi specifičen: „Odgovori v največ 3 stavkih” je učinkovitejše kot „Bodi jedrnat”
- Določi format: navedi, ali pričakuješ JSON, Markdown ali označene sezname
- Postavi omejitve: jasno označi, česa model ne sme storiti
- Zagotovi kontekst: dodaj poslovni kontekst („Si pomočnik za veterinarsko kliniko”)
Vloga user
Sporočila user predstavljajo vnos končnega uporabnika. To so vprašanja, zahteve ali navodila, ki jih pošlje oseba, ki interagira s tvojo aplikacijo.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Sporočilo user se lahko pojavi kjerkoli v pogovoru za sporočilom system. Večkratnem pogovoru se običajno izmenjujeta sporočili user in assistant.
Vloga assistant
Sporočila assistant predstavljajo prejšnje odgovore modela. Ko pošlješ zgodovino pogovora, je vsak odgovor modela Grok označen s to vlogo.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Vlogo assistant lahko uporabiš tudi za pozicioniranje z nekaj primeri (few-shot prompting): vstavljanje primerov želenih odgovorov pred dejansko uporabniško sporočilo.
{
"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."}
]
}
V tem primeru prvi dve izmenjavi med uporabnikom in asistentom služita kot demonstracija. Model razume pričakovani format in bo enako logiko uporabil za tretje sporočilo.
Celotna struktura zahteve
Tukaj je tipičen zahtevek, ki združuje vse tri vloge v večkratnem pogovoru:
{
"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."
}
]
}
Vrstni red je vedno enak: najprej system, nato izmenično user/assistant, pri čemer mora biti zadnje sporočilo nujno user (to je vprašanje, na katerega mora model odgovoriti).
Ključne ugotovitve
- system/developer: navodila razvijalca, vedno prvo, določa splošno obnašanje
- user: sporočila končnega uporabnika, sprožijo generiranje odgovora
- assistant: prejšnji odgovori modela, uporabni za zgodovino in pozicioniranje z nekaj primeri
- Vlogi
systemindevelopersta v API-ju xAI medsebojno zamenljivi - Zadnje sporočilo v polju mora biti sporočilo
user