Konversazzjonijiet Persistenti
F'din il-paġna
Lezzjoni aġġornata fit-3 ta’ Novembru 2026 ibbażata fuq l-SDK
mistralai3.7.0: irkupra l-istorja ta’ konversazzjoni (l-entriestagħha) bl-użu ta’client.beta.conversations.get_history;retrievema jeżistix, ugetjirritorna biss il-metadejta tal-konversazzjoni. Sors: client-python.
Stat li Jippersisti Matul l-Iskambji
Wieħed mill-vantaġġi ewlenin tal-API tal-Aġenti meta mqabbel mal-Chat Completions huwa l-persistenza tal-konversazzjoni. M’għadekx għandek bżonn timmaniġġja manwalment l-istorja tal-messaġġi—Mistral jittrattaha fuq is-server. Speċifikament, il-lista ta’ dizzjunarji li kont tiġbor f’varjabbli, taqta’ meta l-kuntest jimtela, u tibni mill-ġdid f’kull riavvju tal-proċess, tisparixxi mill-kodiċi tiegħek. Għandek bżonn biss traċċa affari waħda: identifikatur. U dak l-identifikatur isegwi regola li tqarraq lil kulħadd fl-ewwel proġett tiegħu.
Tibda Konversazzjoni
Il-metodu conversations.start() joħloq konversazzjoni ġdida u jibgħat l-ewwel messaġġ. L-eżempju li ġej joħloq ukoll l-aġent li se jmexxiha, imbagħad jagħtih kuntest tal-proġett li tista’ tikkonsulta fuq diversi dawriet.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Oħloq aġent
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Assistent tal-Proġett",
description="Assistent għall-ġestjoni tal-proġetti.",
instructions="Inti tgħin torganizza u ssegwi l-proġetti. Kun strutturat."
)
# Ibda l-konversazzjoni
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Qed niedaq proġett ġdid biex nerġgħu niddisinjaw is-sit web tagħna. Baġit: €50K, skadenza: Settembru 2026."
)
print(f"ID tal-Konversazzjoni: {response.conversation_id}")
L-conversation_id irritornat hija ċ-ċavetta tiegħek biex tkompli din il-konversazzjoni aktar tard. Aħżinha fejn l-applikazzjoni tiegħek tista’ terġa’ ssibha: f’sessjoni tal-utent, f’database, jew fit-ticket ta’ appoġġ li tirrigwarda.
Tkomplija ta’ Konversazzjoni
Biex iżżid messaġġ f’konversazzjoni eżistenti, għaddi l-conversation_id lil conversations.append(). Segwi l-fil f’dan l-eżempju: it-tieni mistoqsija ma tirrepetix il-baġit jew l-iskadenza, u t-tielet titlob skeda mingħajr ma tfakkar lill-aġent li huwa ridisinn ta’ sit web. Madankollu, l-aġent għandu dak il-kuntest kollu.
# L-ewwel skambju
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Qed niedaq proġett ta' ridisinn ta' sit web. Baġit €50K."
)
# It-tieni skambju — l-aġent jiftakar il-kuntest
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="X'inhuma l-passi prijoritarji?"
)
# It-tielet skambju — għadu fl-istess kuntest
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Abbozza skeda għall-ewwel 3 xhur."
)
Ara sew liema identifikatur jingħata f’kull sejħa: response2 tibda mill-ID ta’ response1, u response3 minn dik ta’ response2. Din mhix kapriċċ; dan huwa l-mekkaniżmu ewlieni tal-API.
Il-Mekkaniżmu tal-Immutabbiltà
Kull sejħa għal conversations.append() tirritorna ID ġdida ta’ conversation_id. Dik antika tibqa’ tista’ tiġi qari, iżda trid tuża l-aħħar ID għall-appenn li jmiss.
# Kull appenn jirritorna ID ġdida
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Dejjem uża l-aħħar id biex tkompli
response4 = client.beta.conversations.append(
conversation_id=id_3, # Mhux id_1 jew id_2
inputs="Żid milestones ta' validazzjoni tal-klijent."
)
L-iżball klassiku huwa li taħżen l-identifikatur inizjali fid-database tiegħek meta l-utent jiftaħ il-fil, imbagħad terġa’ tużah bħala tali għal kull messaġġ. Xejn ma jaqbeż: l-API tirrispondi normalment, iżda kull mistoqsija terġa’ tibda mill-kuntest tal-ewwel skambju, u l-aġent tiegħek jidher li għandu amneżija mingħajr l-ebda żball li jallertak. Dejjem ikteb fuq l-identifikatur maħżun b’dak irritornat fir-rispons.
Qari tal-Istorja tal-Konversazzjoni
Tista’ taqra l-istorja fi kwalunkwe ħin, li tgħin kemm fid-debugging kif ukoll biex turi fil f’interfaċċa tiegħek.
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]}...")
Ġestjoni tal-Ħażna
B’mod predefinit, il-konversazzjonijiet jinħażnu fis-sħaba ta’ Mistral. Il-parametru store=False jiddiżattiva dan l-imġiba għal skambji li l-politika interna tiegħek tipprojbixxi li jitħallew fuq server ta’ parti terza.
# Konversazzjoni effimera — xejn ma jinħażen
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Data kunfidenzjali biex tiġi analizzata...",
store=False
)
Il-kumpens jaqbel mal-għan: il-konversazzjoni ma tistax tiġi rkuprata wara s-sessjoni, u d-data ma tinżammx fuq is-servers ta’ Mistral. Titlef ir-riproduzzjoni tal-istorja deskritta hawn fuq, u l-applikazzjoni tiegħek trid tittratta t-traċċar tal-iskambji hi stess jekk ikun meħtieġ. Ħu din id-deċiżjoni minn qabel, mhux bħala kaxxa li tiċċekkja fl-aħħar mument.
Mudell ta’ Konversazzjoni Multi-Dawra
L-istruttura hawn taħt tapplika kollox imsemmi hawn fuq f’loop interattiv. Il-punt ewlieni huwa l-varjabbli conversation_id, inizjalizzata għal None: tiddeċiedi liema sejħa ssir—start() fl-ewwel dawra, append() wara—u terġa’ tiġi assenjata wara kull rispons, li ssegwi r-regola tal-immutabbiltà.
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="Kowċ Tekniku",
description="Kowċ għal deċiżjonijiet tekniċi.",
instructions="Inti kowċ tekniku senior. Agħmel mistoqsijiet biex tifhem il-kuntest qabel ma tagħti parir."
)
# Loop tal-konversazzjoni
conversation_id = None
while True:
user_input = input("Inti: ")
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"Aġent: {entry.content}")
Adattaha għall-kuntest tiegħek billi tibdel input() mas-sors reali tal-messaġġi tiegħek—talba HTTP, messaġġ ta’ queue, avveniment ta’ webhook—u tippersistixxi conversation_id fejn l-applikazzjoni tiegħek tista’ ssibha fid-dawra li jmiss.
Punti Ewlenin
conversations.start()toħloq konversazzjoni ġdida b’ewwel messaġġconversations.append()iżżid messaġġ f’konversazzjoni eżistenti- Kull appenn jirritorna ID ġdida ta’
conversation_id—dejjem uża l-aħħar waħda store=Falsejiddiżattiva l-persistenza fuq in-naħa ta’ Mistral għal data sensittiva- L-aġent iżomm il-kuntest sħiħ tal-konversazzjoni mingħajr ma jkollok bżonn terġa’ tibgħat l-istorja