Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Róil: córas, forbróir, úsáideoir, agus cúntóir

Ceacht 2 as 12 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Na ceithre ról teachtaireachta
  2. An ról córais (nó forbróra)
  3. An ról úsáideora
  4. An ról cúntóra
  5. Struchtúr iarratais iomlán
  6. Príomhphointí

Na ceithre ról teachtaireachta

Áirítear réimse role i ngach teachtaireacht a sheoltar chuig an bpointe deiridh Chat Completions, rud a chinneann conas a léirmhíníonn an tsamhail Grok í. Tá sé ríthábhachtach na róil seo a thuiscint chun do chomhráite a struchtúrú agus freagraí ardchaighdeáin a fháil.

Aithníonn API xAI ceithre ról: system, developer, user, agus assistant. Tá suíomh agus úsáid shainiúil ag gach ceann acu laistigh den eagar teachtaireachtaí.

An ról córais (nó forbróra)

Tagann an teachtaireacht system ar dtús san eagar teachtaireachtaí. Sainíonn sí iompar ginearálta na samhla don chomhrá ar fad: ton, formáid freagartha, teorainneacha, pearsantacht, teanga, agus mar sin de.

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

Is ainmneach é an ról developer don ról system. Tá an dá cheann in-idirmhalartaithe in API xAI. Thug OpenAI isteach developer chun an rún a léiriú níos fearr: is iad seo treoracha an fhorbróra, ní treoracha an “chórais”.

Dea-chleachtais don teachtaireacht chórais

  • Bí sonrach: Tá “Freagair i 3 abairt ar a mhéad” níos éifeachtaí ná “Bí gonta”
  • Sainigh an fhormáid: sonraigh an bhfuil súil agat le JSON, Markdown, nó liostaí urchar
  • Socraigh teorainneacha: léirigh cad nach mór don tsamhail a dhéanamh
  • Soláthair comhthéacs: tabhair comhthéacs gnó (“Is cúntóir tú do chlinic tréidliachta”)

An ról úsáideora

Léiríonn teachtaireachtaí user ionchur an úsáideora deiridh. Is iad seo na ceisteanna, na hiarratais, nó na treoracha a sheolann an duine atá ag idirghníomhú le d’iarratas.

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

Is féidir le teachtaireacht user teacht amháil ar bith sa chomhrá tar éis na teachtaireachta córais. I gcomhrá il-chasadh, de ghnáth déanann tú malartú idir teachtaireachtaí user agus assistant.

An ról cúntóra

Léiríonn teachtaireachtaí assistant freagraí roimhe seo na samhla. Nuair a sheolann tú stair chomhrá ar ais, tá an ról seo ar gach freagra ó Grok.

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

Is féidir leat an ról assistant a úsáid freisin le haghaidh leideanna few-shot: samplaí de fhreagraí inmhianaithe a instealladh roimh an teachtaireacht úsáideora iarbhír.

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

Sa sampla seo, feidhmíonn an chéad dá mhalartú úsáideora/cúntóra mar thaispeántas. Tuigeann an tsamhail an fhormáid a bhfuil súil léi agus cuirfidh sí an loighic chéanna i bhfeidhm ar an tríú teachtaireacht.

Struchtúr iarratais iomlán

Seo iarratas tipiciúil a chomhcheanglaíonn na trí ról i gcomhrá il-chasadh:

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

Tá an t-ord mar an gcéanna i gcónaí: system ar dtús, ansin user/assistant ag malartú, agus caithfidh an teachtaireacht dheireanach a bheith ina teachtaireacht user (is í seo an cheist ar cheart don tsamhail freagairt).

Príomhphointí

  • system/developer: treoracha forbróra, i gcónaí ar dtús, sainíonn siad an t-iompar ginearálta
  • user: teachtaireachtaí ón úsáideoir deiridh, spreagann siad giniúint freagartha
  • assistant: freagraí roimhe seo na samhla, úsáideach don stair agus do leideanna few-shot
  • Tá na róil system agus developer in-idirmhalartaithe in API xAI
  • Caithfidh an teachtaireacht dheireanach san eagar a bheith ina teachtaireacht user