Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Vloge: system, developer, user in assistant

Lekcija 2 od 12 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Štiri vloge sporočil
  2. Vloga system (ali developer)
  3. Vloga user
  4. Vloga assistant
  5. Celotna struktura zahteve
  6. Ključne ugotovitve

Štiri vloge sporočil

Vsako sporočilo, poslano končni točki Chat Completions, vključuje polje role, ki določa, kako model Grok razume njegovo vsebino. Razumevanje teh vlog je ključno za pravilno strukturiranje pogovorov in pridobivanje kakovostnih odgovorov.

API xAI prepozna štiri vloge: system, developer, user in assistant. Vsaka ima v polju messages določen položaj in namen uporabe.

Vloga system (ali developer)

Sporočilo system je vedno prvo v polju messages. Določa splošno obnašanje modela za celoten pogovor: ton, format odgovora, omejitve, osebnost, jezik in podobno.

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

Vloga developer je sopomenka za system. V API-ju xAI sta medsebojno zamenljivi. OpenAI je uvedel vlogo developer, da bi bolje odražal namen: gre za navodila razvijalca, ne pa „sistema”.

Najboljše prakse za sporočilo system

  • Bodi specifičen: „Odgovori v največ 3 stavkih” je učinkovitejše kot „Bodi jedrnat”
  • Določi format: navedi, ali pričakuješ JSON, Markdown ali označene sezname
  • Postavi omejitve: jasno označi, česa model ne sme storiti
  • Zagotovi kontekst: dodaj poslovni kontekst („Si pomočnik za veterinarsko kliniko”)

Vloga user

Sporočila user predstavljajo vnos končnega uporabnika. To so vprašanja, zahteve ali navodila, ki jih pošlje oseba, ki interagira s tvojo aplikacijo.

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

Sporočilo user se lahko pojavi kjerkoli v pogovoru za sporočilom system. Večkratnem pogovoru se običajno izmenjujeta sporočili user in assistant.

Vloga assistant

Sporočila assistant predstavljajo prejšnje odgovore modela. Ko pošlješ zgodovino pogovora, je vsak odgovor modela Grok označen s to vlogo.

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

Vlogo assistant lahko uporabiš tudi za pozicioniranje z nekaj primeri (few-shot prompting): vstavljanje primerov želenih odgovorov pred dejansko uporabniško sporočilo.

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

V tem primeru prvi dve izmenjavi med uporabnikom in asistentom služita kot demonstracija. Model razume pričakovani format in bo enako logiko uporabil za tretje sporočilo.

Celotna struktura zahteve

Tukaj je tipičen zahtevek, ki združuje vse tri vloge v večkratnem pogovoru:

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

Vrstni red je vedno enak: najprej system, nato izmenično user/assistant, pri čemer mora biti zadnje sporočilo nujno user (to je vprašanje, na katerega mora model odgovoriti).

Ključne ugotovitve

  • system/developer: navodila razvijalca, vedno prvo, določa splošno obnašanje
  • user: sporočila končnega uporabnika, sprožijo generiranje odgovora
  • assistant: prejšnji odgovori modela, uporabni za zgodovino in pozicioniranje z nekaj primeri
  • Vlogi system in developer sta v API-ju xAI medsebojno zamenljivi
  • Zadnje sporočilo v polju mora biti sporočilo user