Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Perzistentní konverzace

Lekce 5 z 18 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Stav, který přetrvává mezi výměnami
  2. Zahájení konverzace
  3. Pokračování v konverzaci
  4. Mechanismus neměnnosti
  5. Čtení historie konverzace
  6. Správa úložiště
  7. Vzorec pro vícekolovou konverzaci
  8. Klíčové poznatky

Lekce aktualizována 3. listopadu 2026 na základě SDK mistralai verze 3.7.0: historii konverzace (její entries) získáš pomocí client.beta.conversations.get_history; metoda retrieve neexistuje a get vrací 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ávou
  • conversations.append() přidá zprávu do existující konverzace
  • Každé volání append vrací nové conversation_id – vždy použij to nejnovější
  • store=False vypne perzistenci na straně Mistralu pro citlivá data
  • Agent si uchovává celý kontext konverzace, aniž bys musel znovu odesílat historii