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

Comhráite Marthanacha

Ceacht 5 as 18 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Staid a Mhaireann thar Mhalartuithe
  2. Comhrá a Thosú
  3. Comhrá a Leanúint
  4. An Mheicníocht Dho-athraithe
  5. Stair an Chomhrá a Léamh
  6. Bainistiú Stórála
  7. Patrún Comhrá Il-Bhabhta
  8. Príomhphointí

An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar SDK mistralai 3.7.0: faigh stair comhrá (a entries) ag baint úsáide as client.beta.conversations.get_history; níl retrieve ann, agus ní thugann get ach meiteashonraí an chomhrá. Foinse: client-python.

Staid a Mhaireann thar Mhalartuithe

Is é marthanacht an chomhrá ceann de na buntáistí is mó a bhaineann leis an API Gníomhairí i gcomparáid le Críochnuithe Comhrá. Ní gá duit stair na dteachtaireachtaí a bhainistiú de láimh a thuilleadh; déanann Mistral é sin ar an taobh freastalaí. Go sonrach, imíonn an liosta foclóirí a bhíodh agat le carnadh i athróg, a ghearradh nuair a líonadh an comhthéacs, agus a athchruthú ag gach atosú próisis as do chód. Ní gá duit ach rud amháin a rianú: aitheantóir. Agus leanann an t-aitheantóir sin riail a chuireann isteach ar gach duine ina gcéad tionscadal.

Comhrá a Thosú

Cruthaíonn an modh conversations.start() comhrá nua agus seolann sé an chéad teachtaireacht. Cruthaíonn an sampla seo a leanas an gníomhaire a rithfidh é freisin, agus tugann sé comhthéacs tionscadail dó is féidir leat fiosrú thar roinnt babhtaí.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Cruthaigh gníomhaire
agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Cúntóir Tionscadail",
    description="Cúntóir bainistíochta tionscadal.",
    instructions="Cuidíonn tú le tionscadail a eagrú agus a rianú. Bí struchtúrtha."
)

# Tosaigh an comhrá
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Táim ag cur tionscadail nua ar bun chun ár suíomh Gréasáin a athdhearadh. Buiséad: €50K, spriocdháta: Meán Fómhair 2026."
)

print(f"Aitheantas an Chomhrá: {response.conversation_id}")

Is é an conversation_id a fhilltear do eochair chun an comhrá seo a leanúint níos déanaí. Stóráil é in áit ar féidir le d’iarratas teacht air: i seisiún úsáideora, i mbunachar sonraí, nó sa ticéad tacaíochta a bhaineann leis.

Comhrá a Leanúint

Chun teachtaireacht a chur le comhrá atá ann cheana, cuir an conversation_id isteach i conversations.append(). Lean an snáithe sa sampla seo: ní dhéanann an dara ceist an buiséad ná an spriocdháta a athrá, agus iarrann an tríú ceist sceideal gan cuimhneamh don ghníomhaire gur athdhearadh suíomh Gréasáin atá i gceist. Ach tá an comhthéacs sin go léir ag an ngníomhaire.

# An chéad mhalartú
response1 = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Táim ag cur tionscadail athdheartha suíomh Gréasáin ar bun. Buiséad €50K."
)

# An dara malartú — cuimhníonn an gníomhaire ar an gcomhthéacs
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Cad iad na céimeanna tosaíochta?"
)

# An tríú malartú — fós sa chomhthéacs céanna
response3 = client.beta.conversations.append(
    conversation_id=response2.conversation_id,
    inputs="Dréachtaigh sceideal do na chéad 3 mhí."
)

Féach go géar ar cé acu aitheantóir a chothaíonn gach glao: tosaíonn response2 ó ID response1, agus response3 ó ID response2. Ní aisteachas é seo; is é seo bunmheicníocht an API.

An Mheicníocht Dho-athraithe

Tugann gach glao ar conversations.append() nua conversation_id ar ais. Fanann an sean-cheann inléite, ach caithfidh tú an t-ID is déanaí a úsáid don chéad ghlae eile.

# Tugann gach glaie ID nua ar ais
id_1 = response1.conversation_id  # "conv-aaa"
id_2 = response2.conversation_id  # "conv-bbb"
id_3 = response3.conversation_id  # "conv-ccc"

# Úsáid an t-ID is DÉANAÍ i gcónaí chun leanúint ar aghaidh
response4 = client.beta.conversations.append(
    conversation_id=id_3,  # Ní id_1 ná id_2
    inputs="Cuir clocha míle bailíochtaithe an chliaint leis."
)

Is é an botún clasaiceach ná an chéad aitheantóir a shábháil i do bhunachar sonraí nuair a osclaíonn an t-úsáideoir an snáithe, agus ansin é a athúsáid mar atá sé do gach teachtaireacht. Ní tharlaíonn aon rud: freagraíonn an API go gnáth, ach tosaíonn gach ceist ó chomhthéacs an chéad mhalartaithe, agus dealraíonn sé go bhfuil amainéis ar do ghníomhaire gan aon earráid a chur in iúl duit. Scríobh thar an aitheantóir stóráilte leis an gceann a fhilltear sa fhreagra i gcónaí.

Stair an Chomhrá a Léamh

Is féidir leat an stair a léamh ag am ar bith, rud a chuidíonn le dífhabhtú agus le snáithe a thaispeáint i d’interface.

conversation = client.beta.conversations.get_history(
    conversation_id=response.conversation_id
)

for entry in conversation.entries:
    print(f"[{entry.role}] {entry.type}: {entry.content[:100]}...")

Bainistiú Stórála

De réir réamhshocraithe, stóráiltear comhráite i scamall Mistral. Cuireann an paraiméadar store=False stop leis an iompar seo do mhalartuithe a chuireann do pholasaí inmheánach cosc orthu a fhágáil ar fhreastalaí tríú páirtí.

# Comhrá sealadach — ní shábháiltear aon rud
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Sonraí rúnda le hanailísiú...",
    store=False
)

Freagraíonn an malartú don sprioc: ní féidir an comhrá a fháil ar ais tar éis an tseisiúin, agus ní choinnítear na sonraí ar fhreastalaithe Mistral. Cailleann tú an athsheinm staire a tuairiscíodh thuas, agus caithfidh d’iarratas déileáil le rianú na malartuithe féin más gá. Déan an cinneadh seo ar dtús, ní mar bhosca seiceála deireanach.

Patrún Comhrá Il-Bhabhta

Cuireann an creatlach thíos gach rud thuas i bhfeidhm i lúb idirghníomhach. Is é an pointe tábhachtach ná an athróg conversation_id, atá tionscnaithe go None: cinneann sé cé acu glao a dhéanamh—start() ar an gcéad bhabhta, append() ina dhiaidh sin—agus athshannfar é tar éis gach freagra, ag leanúint na rialach do-athraitheachta.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Cóitseálaí Teicniúil",
    description="Cóitseálaí do chinntí teicniúla.",
    instructions="Is cóitseálaí teicniúil sinsearach tú. Cuir ceisteanna chun an comhthéacs a thuiscint sula dtugann tú comhairle."
)

# Lúb comhrá
conversation_id = None

while True:
    user_input = input("Tusa: ")
    if user_input.lower() in ["quit", "exit"]:
        break

    if conversation_id is None:
        response = client.beta.conversations.start(
            agent_id=agent.id,
            inputs=user_input
        )
    else:
        response = client.beta.conversations.append(
            conversation_id=conversation_id,
            inputs=user_input
        )

    conversation_id = response.conversation_id

    for entry in response.outputs:
        if hasattr(entry, "content"):
            print(f"Gníomhaire: {entry.content}")

Oiriúnaigh é do do chomhthéacs féin trí input() a chur in ionad do fhoinse teachtaireachta iarbhír—iarratas HTTP, teachtaireacht ciú, imeacht webhook—agus conversation_id a mharthanú in áit ar féidir le d’iarratas teacht air ar an gcéad bhabhta eile.

Príomhphointí

  • Cruthaíonn conversations.start() comhrá nua leis an gcéad teachtaireacht
  • Cuireann conversations.append() teachtaireacht le comhrá atá ann cheana
  • Tugann gach glaie nua conversation_id ar ais—úsáid an ceann is déanaí i gcónaí
  • Díchumasaíonn store=False marthanacht ar thaobh Mistral do shonraí íogaire
  • Coinníonn an gníomhaire comhthéacs iomlán an chomhrá gan ort an stair a athsheoladh