Roller: system, developer, user og assistant
På denne side
De fire beskedroller
Hver besked, der sendes til Chat Completions-endpointet, indeholder et role-felt, der bestemmer, hvordan Grok-modellen fortolker den. Det er afgørende at forstå disse roller for at strukturere dine samtaler korrekt og opnå svar af høj kvalitet.
xAI API’en genkender fire roller: system, developer, user og assistant. Hver rolle har en specifik placering og anvendelse inden for messages-arrayet.
Rollen system (eller developer)
Beskeden system står altid først i messages-arrayet. Den definerer modellens overordnede adfærd for hele samtalen: tone, svarformat, begrænsninger, personlighed, sprog og så videre.
{
"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 er et alias for system. De to er interchangeable i xAI API’en. OpenAI introducerede developer for bedre at afspejle hensigten: det er udviklerens instrukser, ikke „systemets”.
Bedste praksis for system-beskeden
- Vær specifik: „Svar på maksimalt 3 sætninger” er mere effektivt end „Vær kortfattet”
- Definér formatet: angiv, om du forventer JSON, Markdown eller punktopstillinger
- Sæt grænser: indiker, hvad modellen ikke må gøre
- Giv kontekst: lever forretningsmæssig kontekst („Du er en assistent for en dyreklinik”)
Rollen user
Beskeder med rollen user repræsenterer slutbrugerens input. Det er de spørgsmål, anmodninger eller instrukser, der sendes af personen, der interagerer med din applikation.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
En user-besked kan optræde hvor som helst i samtalen efter system-beskeden. I en samtale med flere ture (multi-turn) vil du typisk skifte mellem user- og assistant-beskeder.
Rollen assistant
Beskeder med rollen assistant repræsenterer modellens tidligere svar. Når du sender en samtaleshistorik tilbage, er hvert svar fra Grok mærket med denne rolle.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Du kan også bruge rollen assistant til few-shot prompting: at injicere eksempler på ønskede svar før den faktiske brugerbesked.
{
"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 dette eksempel fungerer de første to udvekslinger mellem user/assistant som en demonstration. Modellen forstår det forventede format og vil anvende den samme logik på den tredje besked.
Komplet anmodningsstruktur
Her er en typisk anmodning, der kombinerer alle tre roller i en samtale med flere ture:
{
"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."
}
]
}
Rækkefølgen er altid den samme: system først, derefter skiftevis user/assistant, hvor den sidste besked obligatorisk skal være en user-besked (dette er det spørgsmål, modellen skal besvare).
Vigtige pointer
- system/developer: udviklerinstrukser, altid først, definerer overordnet adfærd
- user: slutbrugerbeskeder, udløser generering af svar
- assistant: tidligere modelsvar, nyttige til historik og few-shot prompting
- Rollerne
systemogdeveloperer interchangeable i xAI API’en - Den sidste besked i arrayet skal være en
user-besked