Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Perzistentné konverzácie

Lekcia 5 z 18 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Stav, ktorý pretrváva medzi výmenami
  2. Spustenie konverzácie
  3. Pokračovanie v konverzácii
  4. Mechanizmus nemennosti
  5. Čítanie histórie konverzácie
  6. Správa úložiska
  7. Vzorec viac-kolovej konverzácie
  8. Kľúčové poznatky

Lekcia aktualizovaná 3. novembra 2026 na základe SDK mistralai 3.7.0: históriu konverzácie (jej entries) získaš pomocou client.beta.conversations.get_history; metóda retrieve neexistuje a get vracia 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ávou
  • conversations.append() pridá správu do existujúcej konverzácie
  • Každé volanie append vráti nové conversation_id – vždy použi to najnovšie
  • store=False vypne perzistenciu na strane Mistral pre citlivé údaje
  • Agent si zachováva plný kontext konverzácie, takže nemusíš znova odosielať históriu