Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Roolit: system, developer, user ja assistant

Oppitunti 2 / 12 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Neljä viestiroolia
  2. System- (tai developer-) rooli
  3. User-rooli
  4. Assistant-rooli
  5. Täydellinen pyyntörakenne
  6. Keskeiset asiat

Neljä viestiroolia

Jokainen Chat Completions -päätepisteeseen lähetetty viesti sisältää role-kentän, joka määrittää, miten Grok-malli tulkitsee sen. Näiden roolien ymmärtäminen on välttämätöntä keskustelujen rakentamiselle ja laadukkaiden vastausten saamiselle.

xAI API tunnistaa neljä roolia: system, developer, user ja assistant. Jokaisella on tietty sijainti ja käyttötarkoitus viestitaulukossa.

System- (tai developer-) rooli

system-viesti on viestitaulukon ensimmäinen viesti. Se määrittelee mallin yleisen käyttäytymisen koko keskustelun ajaksi: sävyn, vastausmuodon, rajoitukset, persoonallisuuden, kielen ja niin edelleen.

{
  "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."
}

developer-rooli on system:n alias. Nämä kaksi ovat keskenään vaihdettavissa xAI API:ssa. OpenAI otti käyttöön developer-roolin heijastamaan paremmin tarkoitusta: nämä ovat kehittäjän ohjeita, eivät “järjestelmän”.

Parhaat käytännöt system-viestille

  • Ole spesifi: “Vastaa enintään 3 lauseella” on tehokkaampaa kuin “Ole ytimekäs”
  • Määrittele muoto: määritä, odotatko JSONia, Markdownia vai luettelomerkkejä
  • Aseta rajoitukset: ilmoita, mitä mallin ei tule tehdä
  • Anna konteksti: tarjoa liiketoimintakonteksti (“Olet eläinklinikan avustaja”)

User-rooli

user-viestit edustavat loppukäyttäjän syötettä. Nämä ovat kysymyksiä, pyyntöjä tai ohjeita, jotka sovellustasi käyttävä henkilö lähettää.

{
  "role": "user",
  "content": "What are the 3 most common web vulnerabilities?"
}

user-viesti voi esiintyä missä tahansa keskustelussa system-viestin jälkeen. Monivaiheisessa keskustelussa vuorottelet tyypillisesti user- ja assistant-viestien välillä.

Assistant-rooli

assistant-viestit edustavat mallin aiempia vastauksia. Kun lähetät keskusteluhistorian takaisin, jokainen Grokin vastaus on merkitty tällä roolilla.

{
  "role": "assistant",
  "content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}

Voit käyttää assistant-roolia myös few-shot-kehotteisiin: syöttämällä esimerkkejä halutuista vastauksista ennen varsinaista käyttäjäviestiä.

{
  "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."}
  ]
}

Tässä esimerkissä kaksi ensimmäistä user/assistant-vaihtoa toimivat demonstraationa. Malli ymmärtää odotetun muodon ja soveltaa samaa logiikkaa kolmanteen viestiin.

Täydellinen pyyntörakenne

Tässä on tyypillinen pyyntö, joka yhdistää kaikki kolme roolia monivaiheisessa keskustelussa:

{
  "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."
    }
  ]
}

Järjestys on aina sama: system ensin, sitten vuorottelevat user/assistant, ja viimeisen viestin on oltava ehdottomasti user (tämä on kysymys, johon mallin tulee vastata).

Keskeiset asiat

  • system/developer: kehittäjän ohjeet, aina ensimmäisenä, määrittelee yleisen käyttäytymisen
  • user: loppukäyttäjän viestit, käynnistävät vastauksen generoinnin
  • assistant: mallin aiemmat vastaukset, hyödyllisiä historiaan ja few-shot-kehotteisiin
  • system- ja developer-roolit ovat vaihdettavissa xAI API:ssa
  • Taulukon viimeisen viestin on oltava user-viesti