Roolit: system, developer, user ja assistant
Tällä sivulla
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- jadeveloper-roolit ovat vaihdettavissa xAI API:ssa- Taulukon viimeisen viestin on oltava
user-viesti