Roller: system, developer, user och assistant
På denna sida
De fyra meddelanderollerna
Varje meddelande som skickas till slutpunkten för Chat Completions innehåller ett fält role som avgör hur Grok-modellen tolkar det. Att förstå dessa roller är avgörande för att strukturera dina konversationer och få svar av hög kvalitet.
xAI API:t känner igen fyra roller: system, developer, user och assistant. Varje roll har en specifik position och användning inom matrisen för meddelanden.
Rollen system (eller developer)
Meddelandet system kommer först i matrisen för meddelanden. Det definierar modellens övergripande beteende för hela konversationen: ton, svarsformat, begränsningar, personlighet, språk och så vidare.
{
"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."
}
Rollen developer är ett alias för system. De två är utbytbara i xAI API:t. OpenAI introducerade developer för att bättre spegla avsikten: detta är utvecklarens instruktioner, inte “systemets”.
Bästa praxis för systemmeddelandet
- Var specifik: “Svara på maximalt 3 meningar” är mer effektivt än “Var koncis”
- Definiera formatet: ange om du förväntar dig JSON, Markdown eller punktlistor
- Sätt gränser: indikera vad modellen inte får göra
- Tillhandahåll kontext: ge affärsmässig kontext (“Du är en assistent för en veterinärklinik”)
Rollen user
Meddelanden av typen user representerar slutanvändarens inmatning. Detta är de frågor, förfrågningar eller instruktioner som skickas av personen som interagerar med din applikation.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Ett meddelande av typen user kan förekomma var som helst i konversationen efter systemmeddelandet. I en konversation med flera turer växlar du vanligtvis mellan meddelanden av typen user och assistant.
Rollen assistant
Meddelanden av typen assistant representerar modellens tidigare svar. När du skickar tillbaka en konversationshistorik taggas varje svar från Grok med denna roll.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Du kan också använda rollen assistant för few-shot prompting: att injicera exempel på önskade svar före det faktiska användarmeddelandet.
{
"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."}
]
}
I detta exempel fungerar de två första utbytena mellan user/assistant som en demonstration. Modellen förstår det förväntade formatet och kommer att tillämpa samma logik på det tredje meddelandet.
Komplett förfrågningsstruktur
Här är en typisk förfrågan som kombinerar alla tre roller i en konversation med flera turer:
{
"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."
}
]
}
Ordningen är alltid densamma: system först, sedan växlande user/assistant, där det sista meddelandet obligatoriskt måste vara av typen user (detta är frågan som modellen ska svara på).
Viktiga punkter
- system/developer: utvecklarinstruktioner, alltid först, definierar övergripande beteende
- user: slutanvändarens meddelanden, utlöser svarsgenerering
- assistant: modellens tidigare svar, användbara för historik och few-shot prompting
- Rollerna
systemochdeveloperär utbytbara i xAI API:t - Det sista meddelandet i matrisen måste vara ett meddelande av typen
user