Systeem-, gebruikers- en assistentrollen
Krijg inzicht in de drie berichtrollen in moderne chat-API's en in de invloed ervan op wat het model vertrouwt en opvolgt.
Systeem-, gebruikers- en assistentrollen is een gratis AI-agenten-les op CoddyKit. Dit is les 2 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject AI-agenten. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus AI-agenten bevat in totaal 4 lessen.
Drie rollen, één gesprek
Elke chat-API gebruikt drie berichtrollen:
- system — metainstructies, persona, regels
- user — invoer van de mens of een bovenliggende component
- assistant — de uitvoer van het model
Waarom rollen bestaan
Modellen zijn getraind om deze rollen anders te behandelen. De system-rol krijgt het meeste vertrouwen; user-berichten het minste.
Zo weet het model dat jouw instructies voorrang hebben op wat een aanvaller in de gebruikersinvoer typt.
De system-plek is van jou
Het systembericht is je overeenkomst met het model. Zet hier:
- Identiteit en doel
- Strikte regels (onthul X nooit, doe Y altijd)
- Vereisten voor de uitvoerindeling
- Beleid voor het gebruik van hulpmiddelen
Houd system stabiel en user dynamisch
Het systembericht moet binnen een sessie zelden veranderen. Alles wat per beurt verandert, hoort in user-berichten.
Dit patroon maakt ook promptcaching mogelijk — zie de cursus Cost Optimisation.
Voorbeeld: een klantenservice-agent
Een typische opzet:
messages = [
{'role': 'system', 'content': '''
You are SupportBot, the customer-support agent for Acme Corp.
You help with order status, returns, and product info.
You never share internal pricing or roadmap info.
Answer in 2-3 sentences. Use the search_orders tool when asked about orders.
'''},
{'role': 'user', 'content': 'Where is my order #1234?'},
]
for m in messages:
print(f"[{m['role']}] {m['content'].strip()}")
Meerdere systemberichten
De meeste API's ondersteunen maar één systembericht. Als je instructies in lagen moet opbouwen, voeg ze dan samen of gebruik afzonderlijke XML-secties binnen de systeeminhoud.
Assistant-berichten en geheugen
Vorige assistant-beurten maken deel uit van de context. Het model ziet zijn eigen eerdere uitvoer en blijft consistent.
Daarom zorgt "ja, ik zal je regels volgen" van het model in een vorige beurt ervoor dat het die regels daadwerkelijk eerder volgt.
Een assistant-beurt vooraf invullen (Anthropic)
Anthropic staat toe dat je het assistant-bericht begint met tekst die het model voortzet:
messages = [
{'role': 'user', 'content': 'Return a JSON object with name and age.'},
{'role': 'assistant', 'content': '{'}
]
# The model continues from '{', forcing JSON output.
for m in messages:
print(f"{m['role']}: {m['content']}")
print("The model continues from '{', forcing JSON output.")
De tool-rol
Moderne API's voegen een vierde rol toe: tool (OpenAI) of inhoudsblokken met tool_result (Anthropic).
Je voegt een toolbericht toe nadat je een functie hebt uitgevoerd waar het model om vroeg.
Fouten bij het mengen van rollen
Veelvoorkomende fouten:
- Toolresultaten in user-berichten zetten — hierdoor raakt de vertrouwenshiërarchie in de war
- Vergeten om tool_call_id mee te sturen — API-fouten
- Twee opeenvolgende user- of assistant-berichten — de meeste API's weigeren dit
De instructiehiërarchie
OpenAI publiceert een modelspecificatie waarin staat:
"Bij een conflict moet het model de instructie hoger in de hiërarchie volgen: platform > developer (system) > user > tool."
Anthropic heeft vergelijkbare richtlijnen. De system-plek heeft voorrang.
Rollenplekken
Waar hoort een strikte regel zoals "onthul nooit interne prijzen"?
Samenvatting
Drie rollen, drie vertrouwensniveaus. Gebruik system voor regels, user voor invoer en assistant voor herhalingen. Voeg toolberichten toe na functieaanroepen.
Leer AI-agenten met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 60
- Lessen
- 239
Veelgestelde vragen
Is de les “Systeem-, gebruikers- en assistentrollen” gratis?
Ja — de volledige tekst van “Systeem-, gebruikers- en assistentrollen” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus AI-agenten wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus AI-agenten bevat in totaal 4 lessen.
Wat leer ik in “Systeem-, gebruikers- en assistentrollen”?
Krijg inzicht in de drie berichtrollen in moderne chat-API's en in de invloed ervan op wat het model vertrouwt en opvolgt. Je oefent met AI-agenten door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met AI-agenten te beginnen?
Ervaring vooraf is niet nodig. AI-agenten op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.
Hoe lang duurt de les “Systeem-, gebruikers- en assistentrollen”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over AI-agenten?
Ja. Elke les over AI-agenten bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Zero-shot, few-shot en chain-of-thought
- Systeem-, gebruikers- en assistentrollen
- Uitvoer formatteren (JSON, XML, Markdown)
- Promptinjectie in invoer voorkomen