Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Rollen: system, developer, user en assistant

Les 2 van 12 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. De vier berichtrollen
  2. De system- (of developer-) rol
  3. De user-rol
  4. De assistant-rol
  5. Volledige request-structuur
  6. Belangrijkste punten

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 system en developer zijn uitwisselbaar in de xAI-API
  • Het laatste bericht in de array moet een user-bericht zijn