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

Róil: Córas, Úsáideoir, agus Cúntóir

Ceacht 2 as 16 Nuashonraithe 2 Samhain 2026 Doicnéir
Ar an leathanach seo
  1. Tuiscint a fháil ar an gcóras róil
  2. An ról córais: bunús do leide
  3. An ról úsáideora: an t-iarratas concreideach
  4. An ról cúntóra: treoir a thabhairt don fhreagra
  5. An ról uirlise: torthaí feidhme
  6. Comhrá iomlán a thógáil
  7. Príomhphointí

Tuiscint a fháil ar an gcóras róil

Struchtúraíonn API Comhlánú Comhrá Mistral gach comhrá timpeall ar róil a shanntar do theachtaireachtaí. Caithfidh gach teachtaireacht a sheoltar chuig an tsamhail ról a bheith aici a shainíonn a feidhm sa mhalartú: cé atá ag caint, agus le cé chomh húdarásach. D’fhéadfadh sé go mbeadh an mheicníocht seo cosúil le mionsonra teicniúil, ach is í cnámh droma aon leid ghairmiúil í i ndáiríre – is í an rud a dhéanann idirdhealú idir ceist shimplí a chuirtear i gcomhrá agus feidhmchlár a tógadh go cúramach.

Aithníonn Mistral ceithre ról ar leith, gach ceann acu le feidhm bheacht:

Ról Cur síos Sampla
system Sainíonn pearsantacht, iompar, agus comhthéacs ginearálta na samhla "Is saineolaí dlí Francach tú atá speisialaithe i ndlí saothair."
user Cuimsíonn iarratas nó treoir an úsáideora "Cad iad oibleagáidí an fhostóra i gcás dífhostú eacnamaíoch?"
assistant Léiríonn freagairtí na samhla, nó ligeann duit tús freagartha a réamhlíonadh "Seo na 5 phríomhoibleagáid: 1. ..."
tool Tugann sé toradh glao feidhme ar ais (glao feidhme) Toradh JSON ó chuardach bunachair sonraí

An ról córais: bunús do leide

Tagann an teachtaireacht córais ar dtús sa liosta teachtaireachtaí agus feidhmíonn sí mar threoir bhuan a imríonn tionchar ar an gcomhrá ar fad. Smaoinigh air mar chur síos poist a thabharfá do bhall nua foirne roimh a chéad lá oibre: sainíonn sé an pearsantacht atá ag teastáil (ton, leibhéal foirméalachta, teanga), an réimse saineolais is fearr leat, na rialacha maidir leis an méid ar chóir don tsamhail a dhéanamh nó gan a dhéanamh, agus an formáid réamhshocraithe dá chuid freagairtí. Nuair a scríobhtar an cur síos seo, oireann gach malartú ina dhiaidh sin laistigh den chreatlach seo gan ort é a athrá.

messages = [
    {
        "role": "system",
        "content": """Is scríbhneoir teicniúil sinsearach tú atá speisialaithe i doiciméadú API.
Rialacha:
- Úsáid Béarla teicniúil cruinn
- Cuir samplaí cód Python san áireamh i gcónaí
- Struchtúraigh do chuid freagairtí le ceanntásc agus liostaí
- Ná sáraigh 500 focal in aghaidh na freagartha riamh"""
    },
    {
        "role": "user",
        "content": "Mínigh conas earráidí HTTP a láimhseáil in API REST."
    }
]

Tabhair faoi deara pointe tábhachtach do d’fheidhmchláir amach anseo: is é an forbróir a bhainistíonn an leid chórais, ní an t-úsáideoir deiridh. Ní fheiceann úsáideoir d’fheidhmchláir é riamh, ach tarlaíonn a gcuid idirghníomhaíochtaí go léir laistigh den chreatlach a bhunaigh tú ann. Déanann sé seo do ghiaráil rialaithe is cumhachtaí de.

An ról úsáideora: an t-iarratas concreideach

Cuimsíonn an teachtaireacht úsáideora an t-iarratas sonrach. Is é seo an ról is inbhraite: léiríonn sé an méid a deir an duine leis an tsamhail, agus éiríonn gach ceist nó treoir nua ón úsáideoir ina theachtaireacht leis an ról user. Níor chóir dá shimplíocht dealraitheach dearmad a dhéanamh ort maidir le dea-chleachtais: bí cruinn i d’iarratas, sonraigh an formáid atá ag teastáil mura ionann í agus an ceann a shainítear sa leid chórais, agus soláthair na sonraí atá ag teastáil ón tsamhail go díreach sa teachtaireacht – téacs le hachoimriú, figiúirí le hanailísiú. Ní féidir leis an tsamhail rud ar bith a fháil nach dtugann tú di.

An ról cúntóra: treoir a thabhairt don fhreagra

Is é an ról cúntóra an ceann is lúife de na trí cinn toisc go bhfuil dhá úsáid ar leith aige. Is é an chéad cheann ná stair an chomhrá: i malartú il-chasadh, athchuirtear freagairtí roimhe seo na samhla leis an ról assistant chun an comhthéacs a choinneáil. Seo mar a “chuimhníonn” an tsamhail ar an méid a dúirt sí:

messages = [
    {"role": "user", "content": "Cé í príomhchathair na Fraince?"},
    {"role": "assistant", "content": "Is é Páras príomhchathair na Fraince."},
    {"role": "user", "content": "Agus cad é a daonra?"}
]

Gan an teachtaireacht idirmheánach ón gcúntóir, ní bheadh aon tagairt ag an “a” sa cheist dheireanach: tá an API gan stát, agus athchruthaíonn tú an chuimhne le gach glao.

Is é an dara húsáid ná réamhlíonadh (réimír): is féidir leat do liosta teachtaireachtaí a chríochnú le teachtaireacht assistant ina bhfuil tús na freagartha atá ag teastáil. Leanfaidh an tsamhail ón bpointe seo amach, amhail is dá mba rud é gur tháinig na chéad fhocail as a béal cheana féin. Is teicníc chumhachtach é seo chun formáid an aschuir a rialú:

messages = [
    {"role": "user", "content": "Liostaigh 3 chreatlach Python don ghréasán."},
    {"role": "assistant", "content": "```json\n[", "prefix": True}
]

Tabhair faoi deara an réimse "prefix": True: éilíonn API Mistral é ar an teachtaireacht assistant dheireanach seo chun í a mheas mar thús freagartha.

Anseo, tuigeann an tsamhail go bhfuil sí ag scríobh JSON agus líonfaidh sí an t-eagar a tosaíodh, gan réamhrá ná ráiteas réamhráiteach. I gcás inar féidir treoir téacs “freagair i JSON” a neamhaird, ní fhágann tús freagartha atá scríofa cheana féin mórán rogha.

An ról uirlise: torthaí feidhme

Tagann an ról uirlise i bhfeidhm le linn glao feidhme. Nuair a chinneann an tsamhail feidhm sheachtrach a ghlaoch – cuardach gréasáin, iarratas API, ríomh – seoltar toradh na feidhme sin ar ais chuici mar theachtaireacht tool, a chomhtháthaíonn sí ansin ina freagra. Tá an ról seo níos casta agus clúdófar é i gcúrsaí tiomnaithe; ní gá duit ach a mheabhrú go bhfuil sé ann agus go bhforlíonann sé an tríréad príomhúil.

Comhrá iomlán a thógáil

Déanaimis na heilimintí seo go léir a chur le chéile anois i malartú réadúil, áit a gcuireann an leid chórais fráma timpeall ar an gcúntóir, áit a gcoinníonn an stair an snáithe, agus áit a dtógann an cheist dheireanach go nádúrtha ar an méid a tháinig roimhe:

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "Is cúntóir cócaireachta Francach tú. Freagair go hachomair."
        },
        {
            "role": "user",
            "content": "Conas a dhéanaim vinaigrette clasaiceach?"
        },
        {
            "role": "assistant",
            "content": "Chun vinaigrette clasaiceach a dhéanamh, meascaigh spúnóg mustaird, 3 spúnóg ola olóige, agus spúnóg fíonéad."
        },
        {
            "role": "user",
            "content": "Agus le haghaidh leagan níos éadroime?"
        }
    ]
)

Breathnaigh ar an ailtireacht: córas ar dtús, ansin malartú úsáideora/cúntóra a athchruthaíonn sreabhadh an chomhrá. Níl an t-ordú seo maisiúil – is é an rud a ligeann don tsamhail “leagan níos éadroime” a léirmhíniú i gceart mar leagan den vinaigrette a phléigh sí díreach roimhe seo.

Príomhphointí

  • Cuireann an ról córais fráma timpeall ar iompar ginearálta na samhla – is é seo do ghiaráil is cumhachtaí
  • Iompraíonn an ról úsáideora iarratas concreideach an úsáideora
  • Feidhmíonn an ról cúntóra mar stair agus mar threoir do fhormáid na freagartha araon
  • Láimhseálann an ról uirlise torthaí glao feidhme
  • Tá ord na dteachtaireachtaí ríthábhachtach: córas ar dtús, ansin malartú úsáideora/cúntóra