Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Vaidmenys: system, developer, user ir assistant

Paskaita 2 iš 12 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Keturi žinučių vaidmenys
  2. Vaidmuo system (arba developer)
  3. Vaidmuo user
  4. Vaidmuo assistant
  5. Pilna užklausos struktūra
  6. Svarbiausi punktai

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 system ir developer yra keičiami
  • Paskutinė masyvo žinutė privalo būti user tipo