Pogovori s trajnim stanjem
Na tej strani
Lekcija posodobljena 3. novembra 2026 na podlagi SDK
mistralai3.7.0: zgodovino pogovora (njegoveentries) pridobiš zclient.beta.conversations.get_history; metodaretrievene obstaja,getpa vrne le metapodatke pogovora. Vir: client-python.
Stanje, ki ostane med izmenjavami
Ena glavnih prednosti API-ja za agente v primerjavi z dopolnjevanjem klepetov (Chat Completions) je trajnost pogovora. Zgodovine sporočil ti ni treba več ročno upravljati – Mistral to opravi na strani strežnika. Seznam slovarjev, ki si ga nekoč kopičil v spremenljivki, ob preobremenitvi konteksta okrajšal in ob vsakem ponovnem zagonu procesa znova zgradil, iz tvoje kode izgine. Spremljati moraš le eno stvar: identifikator. Ta identifikator pa sledi pravilu, ki na prvem projektu zmede prav vsakogar.
Začetek pogovora
Metoda conversations.start() ustvari nov pogovor in pošlje prvo sporočilo. Naslednji primer ustvari tudi agenta, ki bo pogovor vodil, in mu dodeli kontekst projekta, ki ga lahko uporabljaš skozi več krogov.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Ustvari agenta
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Pomočnik za projekte",
description="Pomočnik za upravljanje projektov.",
instructions="Pomagaš organizirati in slediti projektom. Bodi strukturiran."
)
# Začni pogovor
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Začenjam nov projekt prenove naše spletne strani. Proračun: 50.000 €, rok: september 2026."
)
print(f"ID pogovora: {response.conversation_id}")
Vrnjeni conversation_id je tvoj ključ za nadaljevanje tega pogovora kasneje. Shrani ga tam, kjer ga tvoja aplikacija lahko ponovno pridobi: v uporabniški seji, bazi podatkov ali v zahtevku za podporo, na katerega se nanaša.
Nadaljevanje pogovora
Če želiš obstoječemu pogovoru dodati sporočilo, predaj conversation_id metodi conversations.append(). Sledi niti v tem primeru: drugo vprašanje ne ponovi proračuna ali roka, tretje pa zahteva razpored, ne da bi agentu znova omenilo, da gre za prenovo spletne strani. Kljub temu ima agent ves ta kontekst.
# Prva izmenjava
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Začenjam projekt prenove spletne strani. Proračun 50.000 €."
)
# Druga izmenjava – agent se spomni konteksta
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Kateri so prednostni koraki?"
)
# Tretja izmenjava – še vedno v istem kontekstu
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Pripravi razpored za prve 3 mesece."
)
Pozorno poglej, kateri identifikator napaja vsak klic: response2 izhaja iz ID-ja response1, response3 pa iz ID-ja response2. To ni muha, temveč temeljni mehanizem API-ja.
Mehanizem nespremenljivosti
Vsak klic conversations.append() vrne nov conversation_id. Stari ostane berljiv, vendar moraš za naslednje dodajanje uporabiti najnovejši ID.
# Vsak append vrne nov ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Za nadaljevanje vedno uporabi NAJNOVEJŠI id
response4 = client.beta.conversations.append(
conversation_id=id_3, # Ne id_1 ali id_2
inputs="Dodaj mejnike za validacijo s strani naročnika."
)
Klasična napaka je shranjevanje začetnega identifikatorja v bazo podatkov, ko uporabnik odpre nit, in njegova ponovna uporaba v nespremenjeni obliki za vsako sporočilo. Nič se ne sesuje: API odgovori normalno, vendar se vsako vprašanje začne znova iz konteksta prve izmenjave in tvoj agent deluje, kot da ima amnezijo, brez kakršnega koli opozorila o napaki. Shranjeni identifikator vedno prepiši z enim, ki je vrnjen v odgovoru.
Branje zgodovine pogovora
Zgodovino lahko prebereš kadarkoli, kar pomaga tako pri odpravljanju napak kot pri prikazu niti v tvojem vmesniku.
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]}...")
Upravljanje shranjevanja
Privzeto so pogovori shranjeni v oblaku Mistral. Parameter store=False to vedenje onemogoči za izmenjave, ki jih tvoja interna pravila prepovedujejo puščati na strežniku tretje strani.
# Efemerni pogovor – nič se ne shrani
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Zaupni podatki za analizo...",
store=False
)
Kompromis ustreza cilju: pogovora po seji ni mogoče obnoviti in podatki niso shranjeni na strežnikih Mistral. Izgubiš zgoraj opisano predvajanje zgodovine, tvoja aplikacija pa mora po potrebi sama prevzeti sledenje izmenjavam. To odločitev sprejmi vnaprej, ne kot zadnjo minuto obkljukano polje.
Vzorec večkrožnega pogovora
Spodnji okostnjak združuje vse zgoraj našteto v interaktivni zanki. Ključna točka je spremenljivka conversation_id, inicializirana na None: ta odloča, kateri klic izvesti – start() ob prvem krogu, append() nato – in se po vsakem odgovoru ponovno dodeli v skladu s pravilom nespremenljivosti.
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="Tehnični trener",
description="Trener za tehnične odločitve.",
instructions="Si višji tehnični trener. Pred svetovanjem zastavi vprašanja za razumevanje konteksta."
)
# Zanka pogovora
conversation_id = None
while True:
user_input = input("Ti: ")
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}")
Prilagodi ga svojemu kontekstu tako, da input() nadomestiš z dejanskim virom sporočil – zahtevo HTTP, sporočilom iz čakalne vrste, dogodkom webhook – in persistiraš conversation_id tam, kjer ga tvoja aplikacija lahko najde ob naslednjem krogu.
Ključne ugotovitve
conversations.start()ustvari nov pogovor s prvim sporočilomconversations.append()doda sporočilo obstoječemu pogovoru- Vsak
appendvrne novconversation_id– vedno uporabi najnovejšega store=Falseonemogoči trajnost na strani Mistrala za občutljive podatke- Agent ohrani celoten kontekst pogovora, ne da bi moral zgodovino znova pošiljati