Püsivad vestlused
Sellel lehel
Õppetund uuendatud 3. novembril 2026, tuginedes
mistralaiSDK versioonile 3.7.0: vestluse ajaloo (selleentries) pärimiseks kasuta meetoditclient.beta.conversations.get_history; meetoditretrieveei eksisteeri jagettagastab ainult vestluse metaandmed. Allikas: client-python.
Olek, mis püsib üle vahetuste
Üks Agents API peamisi eeliseid võrreldes Chat Completionsiga on vestluse püsivus. Sa ei pea enam sõnumite ajalugu käsitsi haldama – Mistral teeb seda serveripoolselt. Täpsemalt öeldes kaob sinu koodist see sõnastike loend, mida varem muutujas kogusid, konteksti ületamisel kärpisid ja iga protsessi taaskäivitamisel uuesti üles ehitasid. Sul tuleb jälgida vaid üht asja: identifikaatorit. See identifikaator allub reeglile, millega põrkub igaüks oma esimeses projektis.
Vestluse alustamine
Meetod conversations.start() loob uue vestluse ja saadab esimese sõnumi. Järgnev näide loob ka agendi, mis seda käivitab, ning annab talle projekti konteksti, mida saad mitme vooru jooksul pärida.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Loo agent
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Projekti assistent",
description="Projektijuhtimise assistent.",
instructions="Sa aitad projekte organiseerida ja jälgida. Ole struktureeritud."
)
# Alusta vestlust
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Käivitan uue projekti meie veebisaidi ümberkujundamiseks. Eelarve: 50 000 €, tähtaeg: september 2026."
)
print(f"Vestluse ID: {response.conversation_id}")
Tagastatud conversation_id on sinu võti selle vestluse hiljem jätkamiseks. Salvesta see kohta, kust sinu rakendus selle leida saab: kasutaja sessiooni, andmebaasi või sellega seotud tugipileti juurde.
Vestluse jätkamine
Olemasolevale vestlusele sõnumi lisamiseks edasta conversation_id meetodile conversations.append(). Jälgi selles näites lõime kulgu: teine küsimus ei korda eelarvet ega tähtaega ja kolmas küsib ajakava, tuletamata agendile meelde, et tegu on veebisaidi ümberkujundamisega. Ometi on agendil kogu see kontekst olemas.
# Esimene vahetus
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Käivitan veebisaidi ümberkujundamise projekti. Eelarve 50 000 €."
)
# Teine vahetus – agent mäletab konteksti
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Millised on prioriteetsed sammud?"
)
# Kolmas vahetus – endiselt samas kontekstis
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Koosta esimese 3 kuu ajakava."
)
Vaata tähelepanelikult, milline identifikaator igale väljakutsele sisendiks antakse: response2 algab response1 ID-st, response3 aga response2 omast. See ei ole veiderdavus, vaid API põhimehhanism.
Muutumatuse mehhanism
Iga conversations.append() väljakutse tagastab uue conversation_id. Vana jääb loetavaks, kuid järgmise lisamise jaoks pead kasutama uusimat ID-d.
# Iga append tagastab uue ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Jätkamiseks kasuta alati UUSIMAT id-d
response4 = client.beta.conversations.append(
conversation_id=id_3, # Mitte id_1 ega id_2
inputs="Lisa kliendi kinnitamise vahe-eesmärgid."
)
Klassikaline viga on salvestada algne identifikaator oma andmebaasi, kui kasutaja lõime avab, ja seejärel kasutada seda iga sõnumi jaoks muutumatuna. Midagi ei kukku kokku: API vastab normaalselt, kuid iga küsimus taaskäivitub esimese vahetuse kontekstist ja sinu agent näib kannatavat mälukaotuse all, ilma et ükski viga sind hoiataks. Kirjuta salvestatud identifikaator alati üle vastuses tagastatuga.
Vestluse ajaloo lugemine
Saad ajalugu igal ajal lugeda, mis aitab nii silumisel kui ka lõime kuvamisel sinu liideses.
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]}...")
Salvestamise haldamine
Vaikimisi salvestatakse vestlused Mistrali pilve. Parameeter store=False keelab selle käitumise vahetuste puhul, mida sinu sisemine poliitika ei luba kolmanda osapoole serverisse jätta.
# Mööduv vestlus – midagi ei salvestata
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Konfidentsiaalsed andmed analüüsiks...",
store=False
)
Kompromiss vastab eesmärgile: vestlust ei saa pärast sessiooni taastada ja andmeid ei hoita Mistrali serverites. Sa kaotad eespool kirjeldatud ajaloo taasesituse võimaluse ja sinu rakendus peab vajadusel vahetuste jälgimisega ise tegelema. Tee see otsus ette, mitte viimase hetke märkeruuduna.
Mitmevoorulise vestluse muster
Allpool olev skeem rakendab kõike eelnevat interaktiivses tsüklis. Võtmepunkt on muutuja conversation_id, mis initsialiseeritakse väärtusega None: see otsustab, milline väljakutse teha – esimeses voorus start(), hiljem append() – ja see omistatakse pärast iga vastust uuesti, järgides muutumatuse reeglit.
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="Tehniline treener",
description="Treener tehniliste otsuste jaoks.",
instructions="Oled vanem tehniline treener. Esita küsimusi, et mõista konteksti enne nõu andmist."
)
# Vestluse tsükkel
conversation_id = None
while True:
user_input = input("Sina: ")
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"Agent: {entry.content}")
Kohanda seda oma konteksti jaoks, asendades input() oma tegeliku sõnumiallikaga – HTTP-päring, järjekorra sõnum või webhooki sündmus – ning püsistades conversation_id kohta, kust sinu rakendus selle järgmises voorus leida saab.
Peamised punktid
conversations.start()loob uue vestluse koos esimese sõnumigaconversations.append()lisab sõnumi olemasolevale vestlusele- Iga
appendtagastab uueconversation_id– kasuta alati uusimat store=Falsekeelab püsivuse Mistrali poolt tundlike andmete jaoks- Agent säilitab kogu vestluse konteksti, ilma et peaksid ajalugu uuesti saatma