Rollen: system, developer, user en assistant
Op deze pagina
De vier berichtrollen
Elk bericht dat naar het Chat Completions-eindpunt wordt verzonden, bevat een role-veld dat bepaalt hoe het Grok-model dit interpreteert. Inzicht in deze rollen is essentieel om uw gesprekken goed te structureren en kwalitatieve antwoorden te krijgen.
De xAI-API herkent vier rollen: system, developer, user en assistant. Elk heeft een specifieke positie en toepassing binnen de messages-array.
De system- (of developer-) rol
Het system-bericht staat altijd eerst in de messages-array. Het definieert het algemene gedrag van het model voor het hele gesprek: toon, antwoordformaat, limieten, persoonlijkheid, taal, enzovoort.
{
"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."
}
De developer-rol is een alias voor system. Beide zijn uitwisselbaar in de xAI-API. OpenAI introduceerde developer om de intentie beter weer te geven: dit zijn instructies van de ontwikkelaar, niet van het “systeem”.
Best practices voor het system-bericht
- Wees specifiek: “Antwoord in maximaal 3 zinnen” werkt beter dan “Wees beknopt”
- Definieer het formaat: geef aan of u JSON, Markdown of opsommingstekens verwacht
- Stel limieten: geef aan wat het model niet mag doen
- Bied context: geef bedrijfscontext (“U bent een assistent voor een dierenartspraktijk”)
De user-rol
user-berichten vertegenwoordigen de input van de eindgebruiker. Dit zijn de vragen, verzoeken of instructies die worden verzonden door de persoon die met uw applicatie interacteert.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Een user-bericht kan overal in het gesprek voorkomen na het system-bericht. Bij een gesprek met meerdere beurten wisselt u doorgaans af tussen user- en assistant-berichten.
De assistant-rol
assistant-berichten vertegenwoordigen de eerdere antwoorden van het model. Wanneer u een gespreksgeschiedenis terugstuurt, krijgt elk antwoord van Grok deze rol mee.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
U kunt de assistant-rol ook gebruiken voor few-shot prompting: het injecteren van voorbeelden van gewenste antwoorden vóór het feitelijke user-bericht.
{
"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."}
]
}
In dit voorbeeld dienen de eerste twee user/assistant-uitwisselingen als demonstratie. Het model begrijpt het verwachte formaat en past dezelfde logica toe op het derde bericht.
Volledige request-structuur
Hier ziet u een typisch request dat alle drie de rollen combineert in een gesprek met meerdere beurten:
{
"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."
}
]
}
De volgorde is altijd hetzelfde: eerst system, daarna afwisselend user/assistant, waarbij het laatste bericht verplicht een user-bericht moet zijn (dit is de vraag die het model moet beantwoorden).
Belangrijkste punten
- system/developer: instructies van de ontwikkelaar, altijd eerst, definieert het algemene gedrag
- user: berichten van de eindgebruiker, triggeren het genereren van antwoorden
- assistant: eerdere modelantwoorden, nuttig voor geschiedenis en few-shot prompting
- De rollen
systemendeveloperzijn uitwisselbaar in de xAI-API - Het laatste bericht in de array moet een
user-bericht zijn