Comhráite Marthanacha
Ar an leathanach seo
An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar SDK
mistralai3.7.0: faigh stair comhrá (aentries) ag baint úsáide asclient.beta.conversations.get_history; nílretrieveann, agus ní thuganngetach 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_idar ais—úsáid an ceann is déanaí i gcónaí - Díchumasaíonn
store=Falsemarthanacht ar thaobh Mistral do shonraí íogaire - Coinníonn an gníomhaire comhthéacs iomlán an chomhrá gan ort an stair a athsheoladh