Role: system, developer, user a assistant
Na této stránce
Čtyři role zpráv
Každá zpráva odeslaná na koncový bod Chat Completions obsahuje pole role, které určuje, jak model Grok tuto zprávu interpretuje. Porozumění těmto rolím je zásadní pro strukturování konverzací a získávání kvalitních odpovědí.
API xAI rozpoznává čtyři role: system, developer, user a assistant. Každá z nich má v poli messages specifické postavení a využití.
Role system (nebo developer)
Zpráva system stojí v poli messages vždy na prvním místě. Definuje celkové chování modelu pro celou konverzaci: tón, formát odpovědi, omezení, osobnost, jazyk a podobně.
{
"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."
}
Role developer je aliasem pro system. V API xAI jsou tyto dvě role zaměnitelné. Společnost OpenAI zavedla roli developer, aby lépe vystihla záměr: jde o pokyny vývojáře, nikoliv „systému“.
Osvědčené postupy pro zprávu system
- Buď konkrétní: „Odpovídej maximálně ve 3 větách“ je účinnější než „Buď stručný“.
- Definuj formát: upřesni, zda očekáváš JSON, Markdown nebo odrážkové seznamy.
- Stanov limity: uveď, co model nesmí dělat.
- Poskytni kontext: dej obchodní kontext („Jsi asistent veterinární kliniky“).
Role user
Zprávy user představují vstup koncového uživatele. Jsou to otázky, požadavky nebo instrukce odeslané osobou, která interaguje s tvou aplikací.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Zpráva user se může v konverzaci objevit kdekoli po zprávě system. Ve vícekolové konverzaci typicky střídáš zprávy user a assistant.
Role assistant
Zprávy assistant představují předchozí odpovědi modelu. Když odešleš historii konverzace zpět, každá odpověď od Groka je označena touto rolí.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Roli assistant můžeš využít také pro few-shot prompting: vkládání příkladů požadovaných odpovědí před skutečnou zprávu uživatele.
{
"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."}
]
}
V tomto příkladu slouží první dvě výměny mezi user a assistant jako demonstrace. Model pochopí očekávaný formát a stejnou logiku aplikuje na třetí zprávu.
Kompletní struktura požadavku
Zde je typický požadavek kombinující všechny tři role ve vícekolové konverzaci:
{
"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."
}
]
}
Pořadí je vždy stejné: nejprve system, poté střídání user/assistant, přičemž poslední zpráva musí být nutně user (to je otázka, na kterou má model odpovědět).
Klíčové poznatky
- system/developer: pokyny vývojáře, vždy první, definují celkové chování
- user: zprávy koncového uživatele, spouští generování odpovědi
- assistant: předchozí odpovědi modelu, užitečné pro historii a few-shot prompting
- Role
systemadeveloperjsou v API xAI zaměnitelné - Poslední zpráva v poli musí být zpráva
user