Perzistentné konverzácie
Na tejto strane
Lekcia aktualizovaná 3. novembra 2026 na základe SDK
mistralai3.7.0: históriu konverzácie (jejentries) získaš pomocouclient.beta.conversations.get_history; metódaretrieveneexistuje agetvracia iba metadáta konverzácie. Zdroj: client-python.
Stav, ktorý pretrváva medzi výmenami
Jednou z hlavných výhod Agents API oproti Chat Completions je perzistencia konverzácie. Už nemusíš ručne spravovať históriu správ – Mistral to rieši na strane servera. Konkrétne zmizne z tvojho kódu zoznam slovníkov, ktorý si musel akumulovať v premennej, skracovať pri zaplnení kontextu a pri každom reštarte procesu znova budovať. Musíš sledovať len jednu vec: identifikátor. A tento identifikátor sa riadi pravidlom, na ktorom sa pri prvom projekte spáli každý.
Spustenie konverzácie
Metóda conversations.start() vytvorí novú konverzáciu a odošle prvú správu. Nasledujúci príklad zároveň vytvorí agenta, ktorý ju bude vykonávať, a poskytne mu kontext projektu, na ktorý sa môžeš odvolávať vo viacerých kolách.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Vytvorenie agenta
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Project Assistant",
description="Project management assistant.",
instructions="You help organize and track projects. Be structured."
)
# Spustenie konverzácie
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="I'm launching a new project to redesign our website. Budget: €50K, deadline: September 2026."
)
print(f"Conversation ID: {response.conversation_id}")
Vrátené conversation_id je tvojím kľúčom na pokračovanie tejto konverzácie neskôr. Ulož ho tam, kde ho tvoja aplikácia dokáže znovu nájsť: do relácie používateľa, databázy alebo do supportového ticketu, ku ktorému sa vzťahuje.
Pokračovanie v konverzácii
Ak chceš pridať správu do existujúcej konverzácie, odovzdaj conversation_id metóde conversations.append(). Sleduj vlákno v tomto príklade: druhá otázka neopakuje rozpočet ani termín a tretia žiada o harmonogram bez pripomínania, že ide o redesign webu. Agent má napriek tomu všetok tento kontext k dispozícii.
# Prvá výmena
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="I'm launching a website redesign project. Budget €50K."
)
# Druhá výmena – agent si pamätá kontext
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="What are the priority steps?"
)
# Tretia výmena – stále v rovnakom kontexte
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Draft a schedule for the first 3 months."
)
Pozorne sa pozri na to, ktorý identifikátor vstupuje do každého volania: response2 vychádza z ID response1, response3 z ID response2. Nie je to zvláštnosť; je to základný mechanizmus API.
Mechanizmus nemennosti
Každé volanie conversations.append() vráti nové conversation_id. Staré zostáva čitateľné, ale na ďalšie pridávanie musíš použiť najnovšie ID.
# Každé append vráti nové ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Na pokračovanie vždy použi NAJNOVŠIE id
response4 = client.beta.conversations.append(
conversation_id=id_3, # Nie id_1 ani id_2
inputs="Add client validation milestones."
)
Klasickou chybou je uložiť si počiatočný identifikátor do databázy hneď pri otvorení vlákna používateľom a potom ho stále dokola používať tak, ako je, pre každú správu. Nič nespadne: API odpovedá normálne, ale každá otázka sa reštartuje z kontextu prvej výmeny a tvoj agent akoby dostal amnéziu, pričom ťa žiadna chyba na to neupozorní. Vždy prepíš uložený identifikátor tým, ktorý prišiel v odpovedi.
Čítanie histórie konverzácie
Históriu si môžeš prečítať kedykoľvek, čo sa hodí tak na ladenie, ako aj na zobrazenie vlákna vo tvojom rozhraní.
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]}...")
Správa úložiska
Konverzácie sa štandardne ukladajú v cloude Mistral. Parameter store=False toto správanie vypne pre výmeny, ktoré tvoja vnútorná politika zakazuje ponechávať na serveri tretej strany.
# Efemérna konverzácia – nič sa neukladá
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Confidential data to analyze...",
store=False
)
Kompromis zodpovedá cieľu: konverzácia nie je po skončení relácie obnoviteľná a údaje nezostávajú na serveroch Mistral. Prídeš o vyššie opísané prehrávanie histórie a tvoja aplikácia si musí v prípade potreby sama riešiť sledovanie výmen. Toto rozhodnutie urob vopred, nie ako poslednú chvíľu zaškrtnuté políčko.
Vzorec viac-kolovej konverzácie
Nižšie uvedená kostra aplikuje všetko vyššie uvedené v interaktívnej slučke. Kľúčovým bodom je premenná conversation_id, inicializovaná na None: rozhoduje o tom, ktoré volanie vykonať – pri prvom kole start(), následne append() – a po každej odpovedi sa prepíše podľa pravidla nemennosti.
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="Technical Coach",
description="Coach for technical decisions.",
instructions="You are a senior technical coach. Ask questions to understand the context before advising."
)
# Slučka konverzácie
conversation_id = None
while True:
user_input = input("You: ")
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}")
Prispôsob si to svojmu kontextu nahradením input() svojim skutočným zdrojom správ – HTTP požiadavkou, správou z fronty, udalosťou webhooku – a ukladaním conversation_id tam, kde ho tvoja aplikácia nájde pri ďalšom kole.
Kľúčové poznatky
conversations.start()vytvorí novú konverzáciu s prvou správouconversations.append()pridá správu do existujúcej konverzácie- Každé volanie
appendvráti novéconversation_id– vždy použi to najnovšie store=Falsevypne perzistenciu na strane Mistral pre citlivé údaje- Agent si zachováva plný kontext konverzácie, takže nemusíš znova odosielať históriu