Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Szerepek: system, developer, user és assistant

2. lecke 12 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. A négy üzenetszerep
  2. A system (vagy developer) szerep
  3. A user szerep
  4. Az assistant szerep
  5. Teljes kérésstruktúra
  6. Főbb megállapítások

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 a developer szerepek felcserélhetők a xAI API-ban
  • A tömb utolsó üzenetének user üzenetnek kell lennie