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

Róil agus Teachtaireachtaí

Ceacht 2 as 16 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Croílár an Phrótacail Chomhrá
  2. Na Ceithre Ról
  3. Struchtúr Iomlán Malartaithe Il-Chas
  4. Ábhar Struchtúrtha
  5. An Bratach Réimír
  6. Príomhphointí

Croílár an Phrótacail Chomhrá

Ní ghlacann an API Chat Completions le téacs amh. Súilíonn sé le sraith teachtaireachtaí struchtúrtha, gach ceann acu sannta do ról sonrach. Ligeann an córas róil seo don mhúnla idirdhealú a dhéanamh idir cé atá ag caint, cad é an comhthéacs, agus conas ba chóir dó freagairt. Tá meáchan difriúil ag an téacs céanna—“Freagair i JSON i gcónaí”—ag brath ar an bhfuil sé ag teacht mar threoir forbróra nó mar ionchur úsáideora. Is é máistreacht a dhéanamh ar an struchtúr seo an rud a scarann chatbot comhleanúnach ó chóras a théann ar seachrán tar éis trí mhalartú.

Na Ceithre Ról

Aithníonn API Mistral ceithre ról ar leith, agus feidhm bheacht ag gach ceann acu sa chomhrá.

An Ról system

Sainíonn an teachtaireacht chórais iompar ginearálta an mhúnla. Cuirtear ar dtús í, agus léitear í sula dtarlaíonn aon mhalartú. Seo an áit a socraíonn tú an tón, na srianta agus an comhthéacs do d’fheidhmchlár. Samhlaigh cúntóir deartha do dhlíchomhlacht; is ionann an teachtaireacht chórais agus an nóta treorach a thabharfá do chomhlaí nua sula dtosaíonn siad ar a gcéad chás.

messages = [
    {
        "role": "system",
        "content": "You are a legal assistant specializing in French law. "
                   "Respond precisely and cite relevant legal articles. "
                   "If you are unsure, state it explicitly."
    }
]

Is é an forbróir a bhainistíonn an teachtaireacht seo, ní an t-úsáideoir deiridh riamh, agus ní fheictear í riamh i gcomhéadan d’fheidhmchláir.

An Ról user

Tagann teachtaireacht an úsáideora dhaonna ina diaidh sin: an cheist, an treoir, nó an téacs le próiseáil. Is é seo an t-aon chuid den chomhrá a rialaíonn do chuid úsáideoirí go díreach.

messages.append({
    "role": "user",
    "content": "What are the statutes of limitations in civil law?"
})

An Ról assistant

Coinníonn an ról seo freagraí roimhe seo ón mhúnla. Éiríonn sé riachtanach nuair a sháraíonn an comhrá malartú amháin. Gan é, d’fhágfadh úsáideoir a chuireann ceist mar “Cad faoi fhiachas tráchtála?” freagairt as ábhar air, toisc nach mbeadh a fhios ag an mhúnla cad faoinar bhíothas ag plé.

messages.append({
    "role": "assistant",
    "content": "In French civil law, the standard statute of limitations is 5 years..."
})

An Ról tool

Tagann an ról deiridh i gceist le linn glao feidhme. Nuair a iarrann an mhúnla feidhm sheachtrach a rith—ceist a chur ar API aimsire, mar shampla—riteann tú an fheidhm sin ar do thaobhsa agus filleann tú an toradh faoin ról seo, ag tagairt do ID an ghlao shonraigh:

messages.append({
    "role": "tool",
    "content": '{"temperature": 22, "city": "Paris"}',
    "tool_call_id": "call_abc123"
})

Struchtúr Iomlán Malartaithe Il-Chas

Feicimis na róil seo i mbun gnímh le linn comhrá fíor áit a ndéanann an t-úsáideoir a n-iarratas a bheachtú tar éis freagra tosaigh:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

conversation = [
    {
        "role": "system",
        "content": "You are a French chef. Propose simple and tasty recipes."
    },
    {
        "role": "user",
        "content": "I want to make a dessert with apples."
    }
]

# First turn
response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

assistant_reply = response.choices[0].message.content
print(assistant_reply)

# Add response to history
conversation.append({"role": "assistant", "content": assistant_reply})

# Second turn
conversation.append({
    "role": "user",
    "content": "Can you adapt this recipe for 8 people?"
})

response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

print(response.choices[0].message.content)

Tabhair faoi deara cad a dhéanann an cód seo i ndáiríre: ag gach cas, seolann sé ar ais an stair iomlán. Níl aon chuimhne leanúnach ag an mhúnla idir iarratais. Ní chiallaíonn “an oideas seo” aon rud ach amháin toisc go bhfuil an freagra roimhe sin fós sa sraith. Is tusa atá freagrach go hiomlán as staid an chomhrá a bhainistiú.

Ábhar Struchtúrtha

Glacann an réimse content le dhá fhoirm. Is é teaghrán simplí an ceann is coitianta. Ach chomh luath agus a tharchuireann tú rud éigin seachas téacs—íomhá le cur síos uirthi, mar shampla—aistríonn tú go dtí liosta blocanna de chineálacha:

# Simple content (text)
{"role": "user", "content": "Describe this image."}

# Structured content (multimodal)
{"role": "user", "content": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

An Bratach Réimír

Tairgeann Mistral gné uathúil: an bratach réimír (prefix flag). Scríobhann tú tús freagra an chúntóra tú féin, agus tá an mhúnla ialtaithe leanúint air ón bpointe sin. Tá sé seo thar a bheith éifeachtach nuair a theastaíonn uait an t-aschur a pharsáil gan aon spás d’earráid.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "system", "content": "You always respond in JSON."},
        {"role": "user", "content": "List 3 European capitals."},
        {"role": "assistant", "content": '{"capitals": [', "prefix": True}
    ]
)

Tosaíonn an mhúnla an ghiniúint arís tar éis {"capitals": [, ag díothú láithreach an riosca go bhfeicfí “Sure, here is your JSON:” ag teacht roimh an lúibín oscailte. Sa táirgeadh, is minic a bhíonn an ráthaíocht formáide seo níos luachmhaire ná treoir arna hathrá trí huaire sa teachtaireacht chórais.

Glac dhá nós láithreach. Coinnigh an teachtaireacht chórais gonta: tugann mír amháin scríofa go maith torthaí níos fearr ná dhá leathanach rialacha, cuid acu a dhéanfaidh an mhúnla neamhaird orthu sa deireadh. Agus ná cum freagraí bréige cúntóra riamh chun an mhúnla a threorú, ach amháin i gcás amháin—foghlaim cúpla-sampla (few-shot learning), a phléfimid i gCeacht 10. I gcomhair comhráite fada, seol an stair iomlán, ach déan monatóireacht ar fhuinneog an chomhthéacs agus bain na malartuithe is sine sula sáraíonn tú í.

Príomhphointí

  • Ceithre ról: system (iompar), user (iarratas), assistant (freagra), tool (toradh feidhme)
  • Téann an teachtaireacht chórais ar dtús agus sainíonn sí creatlach an fheidhmchláir
  • Níl cuimhne ag an mhúnla: seol an stair iomlán le gach iarratas
  • Éigníonn an bhratach réimír tús na freagra chun formáid an aschuir a rialú