Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ir-rwoli: system, developer, user, u assistant

Lezzjoni 2 / 12 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-erba’ rwoli tal-messaġġi
  2. Ir-rwol tas-system (jew developer)
  3. Ir-rwol tal-user
  4. Ir-rwol tal-assistant
  5. Struttura sħiħa tat-talba
  6. Punti Ewlenin

L-erba’ rwoli tal-messaġġi

Kull messaġġ mibgħut lit-tarf tal-Chat Completions jinkludi qasam role li jiddetermina kif il-mudell Grok jinterpretah. Li tifhem dawn ir-rwoli huwa essenzjali biex tistruttura l-konversazzjonijiet tiegħek u tikseb tweġibiet ta’ kwalità.

L-API ta’ xAI tirrikonoxxi erba’ rwoli: system, developer, user, u assistant. Kull wieħed għandu pożizzjoni u użu speċifiku fi ħdan l-array tal-messaġġi.

Ir-rwol tas-system (jew developer)

Il-messaġġ system jiġi l-ewwel fl-array tal-messaġġi. Dan jiddefinixxi l-imġiba ġenerali tal-mudell għall-konversazzjoni kollha: it-ton, il-format tat-tweġiba, il-limiti, il-personalità, il-lingwa, u hekk fuq.

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

Ir-rwol developer huwa alias għal system. It-tnejn huma interkambjabbli fl-API ta’ xAI. OpenAI introduċiet developer biex tirrifletti aħjar l-intenzjoni: dawn huma l-istruzzjonijiet tal-iżviluppatur, mhux tas-”system”.

L-aħjar prattiki għall-messaġġ tas-system

  • Kun speċifiku: “Wieġeb f’massimu ta’ 3 sentenzi” huwa aktar effettiv minn “Kun konċiż”
  • Iddefinixxi l-format: speċifika jekk tistennax JSON, Markdown, jew listi b’bullits
  • Stabbilixxi limiti: indika x’għandu jagħmel il-mudell
  • Ipprovdi kuntest: agħti kuntest tan-negozju (“Int assistent għal klinika veterinarja”)

Ir-rwol tal-user

Il-messaġġi user jirrappreżentaw l-input tal-utent finali. Dawn huma l-mistoqsijiet, it-talbiet, jew l-istruzzjonijiet mibgħuta mill-persuna li qed tinteraġixxi mal-applikazzjoni tiegħek.

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

Messaġġ user jista’ jidher kullimkien fil-konversazzjoni wara l-messaġġ tas-system. F’konversazzjoni b’diversi dawriet, tipikament talternaw bejn messaġġi user u assistant.

Ir-rwol tal-assistant

Il-messaġġi assistant jirrappreżentaw it-tweġibiet preċedenti tal-mudell. Meta tibgħat lura storja ta’ konversazzjoni, kull tweġiba minn Grok tiġi mmarkata b’dan ir-rwol.

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

Tista’ tuża wkoll ir-rwol assistant għall-few-shot prompting: li tinjetta eżempji ta’ tweġibiet mixtieqa qabel il-messaġġ attwali tal-utent.

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

F’dan l-eżempju, l-ewwel żewġ skambji bejn user/assistant iservu bħala dimostrazzjoni. Il-mudell jifhem il-format mistenni u japplika l-istess loġika għat-tielet messaġġ.

Struttura sħiħa tat-talba

Hawnhekk hemm talba tipika li tgħaqqad it-tliet rwoli f’konversazzjoni b’diversi dawriet:

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

L-ordni hija dejjem l-istess: system l-ewwel, imbagħad alternanza bejn user/assistant, bl-aħħar messaġġ obbligatorjament ikun user (din hija l-mistoqsija li l-mudell irid iwieġeb).

Punti Ewlenin

  • system/developer: istruzzjonijiet tal-iżviluppatur, dejjem l-ewwel, jiddefinixxu l-imġiba ġenerali
  • user: messaġġi tal-utent finali, jattivaw il-ġenerazzjoni tat-tweġiba
  • assistant: tweġibiet preċedenti tal-mudell, utli għall-istorja u għall-few-shot prompting
  • Ir-rwoli system u developer huma interkambjabbli fl-API ta’ xAI
  • L-aħħar messaġġ fl-array irid ikun messaġġ user