Vaidmenys: system, developer, user ir assistant
Šiame puslapyje
Keturi žinučių vaidmenys
Kiekviena žinutė, siunčiama į „Chat Completions“ galinį tašką, turi lauką role, kuris nulemia, kaip Grok modelis ją interpretuos. Suprasti šiuos vaidmenis būtina norint tinkamai struktūruoti pokalbius ir gauti kokybiškus atsakymus.
xAI API atpažįsta keturis vaidmenis: system, developer, user ir assistant. Kiekvienas iš jų turi specifinę vietą ir paskirtį žinučių masyve.
Vaidmuo system (arba developer)
Žinutė system žinučių masyve visada eina pirmoji. Ji apibrėžia bendrą modelio elgseną visam pokalbiui: toną, atsakymo formatą, ribas, asmenybę, kalbą ir kt.
{
"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."
}
Vaidmuo developer yra system aliasas. xAI API šie du vaidmenys yra visiškai keičiami. „OpenAI“ pristatė developer, kad tiksliau atspindėtų paskirtį: tai kūrėjo instrukcijos, o ne „sistemos“.
Geriausios praktikos kuriant system žinutę
- Būk konkretus: „Atsakyk ne ilgiau kaip 3 sakiniais“ yra efektyviau nei „Būk glaustas“
- Apibrėžk formatą: nurodyk, ar tikiesi JSON, Markdown, ar sąrašo su punktais
- Nustatyk ribas: parodyk, ko modelis daryti neturi
- Pateik kontekstą: duok verslo kontekstą („Esi veterinarijos klinikos asistentas“)
Vaidmuo user
Žinutės user reprezentuoja galutinio naudotojo įvestį. Tai klausimai, prašymai ar instrukcijos, kurias siunčia asmuo, bendraujantis su tavo programa.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Žinutė user gali atsirasti bet kurioje pokalbio vietoje po system žinutės. Daugiapakopio pokalbio metu paprastai pakaitomis siunčiamos user ir assistant žinutės.
Vaidmuo assistant
Žinutės assistant reprezentuoja ankstesnius modelio atsakymus. Kai siunti pokalbio istoriją atgal, kiekvienas Grok atsakymas pažymimas šiuo vaidmeniu.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Vaidmenį assistant taip pat gali naudoti few-shot prompting metodui: prieš tikrąją naudotojo žinutę įterpti pageidaujamų atsakymų pavyzdžių.
{
"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."}
]
}
Šiame pavyzdyje pirmieji du user/assistant mainai tarnauja kaip demonstracija. Modelis supranta numatomą formatą ir tą pačią logiką pritaikys trečiajai žinutei.
Pilna užklausos struktūra
Štai tipinė užklausa, sujungianti visus tris vaidmenis daugiapakopio pokalbio metu:
{
"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."
}
]
}
Tvarka visada ta pati: pirmiausia system, tada pakaitomis user/assistant, o paskutinė žinutė privalo būti user (tai klausimas, į kurį modelis turi atsakyti).
Svarbiausi punktai
- system/developer: kūrėjo instrukcijos, visada pirmos, apibrėžia bendrą elgseną
- user: galutinio naudotojo žinutės, inicijuoja atsakymų generavimą
- assistant: ankstesni modelio atsakymai, naudingi istorijai ir few-shot prompting
- xAI API vaidmenys
systemirdeveloperyra keičiami - Paskutinė masyvo žinutė privalo būti
usertipo