Perzistentní konverzace
Na této stránce
Lekce aktualizována 3. listopadu 2026 na základě SDK
mistralaiverze 3.7.0: historii konverzace (jejíentries) získáš pomocíclient.beta.conversations.get_history; metodaretrieveneexistuje agetvrací pouze metadata konverzace. Zdroj: client-python.
Stav, který přetrvává mezi výměnami
Jednou z hlavních výhod Agents API oproti Chat Completions je perzistence konverzace. Už nemusíš ručně spravovat historii zpráv – Mistral to řeší na straně serveru. Konkrétně seznam slovníků, který jsi dříve hromadil v proměnné, zkracoval při přeplnění kontextu a při každém restartu procesu znovu budoval, z tvého kódu zmizí. Musíš sledovat jen jednu věc: identifikátor. A tento identifikátor se řídí pravidlem, na kterém při prvním projektu narazí úplně každý.
Zahájení konverzace
Metoda conversations.start() vytvoří novou konverzaci a odešle první zprávu. Následující příklad také vytvoří agenta, který ji bude provádět, a poskytne mu kontext projektu, na který se můžeš ptát v několika kolech.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Vytvoření agenta
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Asistent projektu",
description="Asistent pro řízení projektů.",
instructions="Pomáháš organizovat a sledovat projekty. Buď strukturovaný."
)
# Zahájení konverzace
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Spouštím nový projekt na redesign našeho webu. Rozpočet: 50 000 €, termín: září 2026."
)
print(f"ID konverzace: {response.conversation_id}")
Vrácené conversation_id je tvým klíčem pro pokračování v této konverzaci později. Ulož si ho tam, kde ho tvoje aplikace dokáže znovu najít: do uživatelské relace, databáze nebo do support ticketu, ke kterému se vztahuje.
Pokračování v konverzaci
Chceš-li přidat zprávu do existující konverzace, předej conversation_id metodě conversations.append(). Sleduj vlákno v tomto příkladu: druhá otázka neopakuje rozpočet ani termín a třetí žádá o harmonogram, aniž by agenta připomínala, že jde o redesign webu. Přesto má agent celý tento kontext k dispozici.
# První výměna
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Spouštím projekt redesignu webu. Rozpočet 50 000 €."
)
# Druhá výměna – agent si pamatuje kontext
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Jaké jsou prioritní kroky?"
)
# Třetí výměna – stále ve stejném kontextu
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Navrhni harmonogram na první 3 měsíce."
)
Podívej se pozorně na to, který identifikátor napájí jednotlivá volání: response2 vychází z ID response1, response3 z ID response2. Není to žádná zvláštnost; je to základní mechanismus API.
Mechanismus neměnnosti
Každé volání conversations.append() vrací nové conversation_id. To staré zůstává čitelné, ale pro další připojení musíš použít nejnovější ID.
# Každé append vrátí nové ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Vždy použij NEJNOVĚJŠÍ id pro pokračování
response4 = client.beta.conversations.append(
conversation_id=id_3, # Ne id_1 ani id_2
inputs="Přidej milníky schválení klientem."
)
Klasickou chybou je uložit počáteční identifikátor do databáze ve chvíli, kdy uživatel otevře vlákno, a poté ho pokaždé použít tak, jak je, pro každou zprávu. Nic nespadne: API odpoví normálně, ale každá otázka restartuje kontext od první výměny a tvůj agent bude působit, jako by měl amnézii, aniž by tě jakákoli chyba upozornila. Vždy přepiš uložený identifikátor tím, který byl vrácen v odpovědi.
Čtení historie konverzace
Historii si můžeš přečíst kdykoli, což se hodí jak pro ladění, tak pro zobrazení vlákna ve tvém 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žiště
Ve výchozím nastavení jsou konverzace uloženy v cloudu Mistral. Parametr store=False toto chování vypne pro výměny, které tvoje interní politika zakazuje ponechávat na serveru třetí strany.
# Efemérní konverzace – nic se neukládá
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Důvěrná data k analýze...",
store=False
)
Kompromis odpovídá cíli: konverzaci po skončení relace nelze obnovit a data nezůstávají na serverech Mistral. Přicházíš o výše popsané přehrávání historie a tvoje aplikace musí v případě potřeby sama řešit sledování výměn. Toto rozhodnutí učiň předem, ne jako poslední chvíli zaškrtnuté políčko.
Vzorec pro vícekolovou konverzaci
Následující kostra aplikuje vše výše uvedené v interaktivní smyčce. Klíčovým bodem je proměnná conversation_id, inicializovaná na None: rozhoduje o tom, které volání provést – start() při prvním kole, append() poté – a po každé odpovědi se přepisuje v souladu s pravidlem neměnnosti.
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="Technický kouč",
description="Kouč pro technická rozhodnutí.",
instructions="Jsi senior technický kouč. Před poradenstvím klad otázky, abys pochopil kontext."
)
# Smyčka konverzace
conversation_id = None
while True:
user_input = input("Ty: ")
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}")
Přizpůsob ji svému kontextu nahrazením input() svým skutečným zdrojem zpráv – HTTP požadavek, zpráva z fronty, událost webhooku – a uchováním conversation_id tam, kde ho tvoje aplikace najde v dalším kole.
Klíčové poznatky
conversations.start()vytvoří novou konverzaci s první zprávouconversations.append()přidá zprávu do existující konverzace- Každé volání
appendvrací novéconversation_id– vždy použij to nejnovější store=Falsevypne perzistenci na straně Mistralu pro citlivá data- Agent si uchovává celý kontext konverzace, aniž bys musel znovu odesílat historii