Salt la conținutul principal
Română— Alege o limbă
Meniu

Roluri: system, developer, user și assistant

Lecția 2 din 12 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Cele patru roluri ale mesajelor
  2. Rolul system (sau developer)
  3. Rolul user
  4. Rolul assistant
  5. Structura completă a cererii
  6. Puncte cheie

Cele patru roluri ale mesajelor

Fiecare mesaj trimis către punctul final Chat Completions include un câmp role care determină modul în care modelul Grok îl interpretează. Înțelegerea acestor roluri este esențială pentru structurarea conversațiilor și obținerea unor răspunsuri de calitate.

API-ul xAI recunoaște patru roluri: system, developer, user și assistant. Fiecare are o poziție și o utilizare specifică în cadrul tabloului de mesaje.

Rolul system (sau developer)

Mesajul system vine primul în tabloul de mesaje. Acesta definește comportamentul global al modelului pentru întreaga conversație: ton, format de răspuns, limite, personalitate, limbă și așa mai departe.

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

Rolul developer este un alias pentru system. Cele două sunt interschimbabile în API-ul xAI. OpenAI a introdus developer pentru a reflecta mai bine intenția: acestea sunt instrucțiunile dezvoltatorului, nu ale „sistemului“.

Cele mai bune practici pentru mesajul system

  • Fiți specific: „Răspundeți în maximum 3 propoziții“ este mai eficient decât „Fiți concis“
  • Definiți formatul: specificați dacă vă așteptați la JSON, Markdown sau liste cu puncte
  • Stabiliți limite: indicați ce nu trebuie să facă modelul
  • Oferiți context: furnizați context de afaceri („Sunteți un asistent pentru o clinică veterinară“)

Rolul user

Mesajele user reprezintă input-ul utilizatorului final. Acestea sunt întrebările, cererile sau instrucțiunile trimise de persoana care interacționează cu aplicația dumneavoastră.

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

Un mesaj user poate apărea oriunde în conversație, după mesajul system. Într-o conversație cu mai multe tururi, alternați de obicei între mesajele user și assistant.

Rolul assistant

Mesajele assistant reprezintă răspunsurile anterioare ale modelului. Când trimiteți înapoi un istoric al conversației, fiecare răspuns de la Grok este etichetat cu acest rol.

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

Puteți utiliza, de asemenea, rolul assistant pentru few-shot prompting: injectarea de exemple de răspunsuri dorite înainte de mesajul real al utilizatorului.

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

În acest exemplu, primele două schimburi user/assistant servesc drept demonstrație. Modelul înțelege formatul așteptat și va aplica aceeași logică celui de-al treilea mesaj.

Structura completă a cererii

Iată o cerere tipică care combină toate cele trei roluri într-o conversație cu mai multe tururi:

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

Ordinea este întotdeauna aceeași: system primul, apoi alternarea user/assistant, iar ultimul mesaj fiind obligatoriu user (aceasta este întrebarea la care modelul trebuie să răspundă).

Puncte cheie

  • system/developer: instrucțiuni pentru dezvoltator, întotdeauna primul, definește comportamentul global
  • user: mesaje ale utilizatorului final, declanșează generarea răspunsului
  • assistant: răspunsuri anterioare ale modelului, utile pentru istoric și few-shot prompting
  • Rolurile system și developer sunt interschimbabile în API-ul xAI
  • Ultimul mesaj din tablou trebuie să fie un mesaj user