Szerepek: system, developer, user és assistant
Ezen az oldalon
A négy üzenetszerep
Minden, a Chat Completions végpontra küldött üzenet tartalmaz egy role mezőt, amely meghatározza, hogyan értelmezi a Grok modell az adott üzenetet. E szerepek megértése elengedhetetlen a beszélgetések megfelelő felépítéséhez és a minőségi válaszok eléréséhez.
A xAI API négy szerepet ismer: system, developer, user és assistant. Mindegyiknek meghatározott helye és felhasználási módja van az üzenettömbben.
A system (vagy developer) szerep
A system üzenet áll elsőként az üzenettömbben. Ez határozza meg a modell általános viselkedését a teljes beszélgetés során: a hangnemet, a válaszformátumot, a korlátokat, a személyiséget, a nyelvet és így tovább.
{
"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."
}
A developer szerep a system aliasa. A kettő felcserélhető a xAI API-ban. Az OpenAI vezette be a developer szerepet, hogy jobban tükrözze a szándékot: ezek a fejlesztő utasításai, nem pedig a „rendszeré“.
Bevált gyakorlatok a system üzenethez
- Légy konkrét: A „Válasszol maximum 3 mondatban“ hatékonyabb, mint a „Légy tömör“.
- Határozd meg a formátumot: Add meg, ha JSON-t, Markdownot vagy felsorolást vársz.
- Szabj korlátokat: Jelezd, mit nem szabad csinálnia a modellnek.
- Adj kontextust: Biztosíts üzleti kontextust (pl. „Te egy állatorvosi rendelő asszisztense vagy“).
A user szerep
A user üzenetek a végfelhasználó bemenetét képviselik. Ezek azok a kérdések, kérések vagy utasítások, amelyeket az alkalmazásoddal interacting személy küld.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Egy user üzenet a system üzenet után a beszélgetés bármely pontján megjelenhet. Több körös beszélgetés esetén jellemzően váltakoznak a user és az assistant üzenetek.
Az assistant szerep
Az assistant üzenetek a modell korábbi válaszait képviselik. Amikor visszaküldesz egy beszélgetési előzményt, a Grok minden egyes válaszát ezzel a szereppel látod el.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Az assistant szerepet few-shot prompting (példaalapú promptolás) céljára is használhatod: a tényleges felhasználói üzenet előtt kívánt válaszokat tartalmazó példákat szúrhatsz be.
{
"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."}
]
}
Ebben a példában az első két user/assistant párbeszéd demonstrációként szolgál. A modell megérti az elvárt formátumot, és ugyanazt a logikát alkalmazza a harmadik üzenetre is.
Teljes kérésstruktúra
Íme egy tipikus kérés, amely mindhárom szerepet egyesíti egy több körös beszélgetésben:
{
"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."
}
]
}
A sorrend mindig ugyanaz: először a system, majd váltakozva a user és assistant, ahol az utolsó üzenetnek kötelezően user üzenetnek kell lennie (ez az a kérdés, amelyre a modellnek válaszolnia kell).
Főbb megállapítások
- system/developer: fejlesztői utasítások, mindig elsőként, meghatározza az általános viselkedést
- user: végfelhasználói üzenetek, ezek indítják el a válaszgenerálást
- assistant: korábbi modellválaszok, hasznosak az előzményekhez és a few-shot promptinghoz
- A
systemés adeveloperszerepek felcserélhetők a xAI API-ban - A tömb utolsó üzenetének
userüzenetnek kell lennie