Róil: Córas, Úsáideoir, agus Cúntóir
Ar an leathanach seo
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