Folyamatos beszélgetések
Ezen az oldalon
Lecke frissítve: 2026. november 3. a
mistralaiSDK 3.7.0 verziója alapján: a beszélgetés előzményeinek (azentrieslista) lekérdezéséhez használd aclient.beta.conversations.get_historymetódust; aretrievenem létezik, agetpedig csak a beszélgetés metaadatait adja vissza. Forrás: client-python.
Állapot, amely megmarad a váltások során
Az Ügynökök API egyik legnagyobb előnye a Chat Completionshez képest a beszélgetések megőrzése. Többé nem kell manuálisan kezelned az üzenetek előzményeit – a Mistral ezt szerveroldalon intézi. Konkrétabban: eltűnik a kódodból az a szótárlista, amelyet korábban egy változóban halmoztál fel, levágtál, ha túllépte a kontextus limitet, és minden folyamat-újraindításkor újraépítettél. Csak egyetlen dolgot kell nyomon követned: egy azonosítót. Ez az azonosító pedig egy olyan szabályt követ, amelybe mindenki belefut az első projektjében.
Beszélgetés indítása
A conversations.start() metódus létrehoz egy új beszélgetést, és elküldi az első üzenetet. Az alábbi példa létrehozza a futtatáshoz szükséges ügynököt is, majd biztosít egy projekt-kontextust, amelyet több körön át lekérdezhetsz.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Ügynök létrehozása
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Projekt asszisztens",
description="Projektmenedzsment asszisztens.",
instructions="Segítesz a projektek szervezésében és nyomon követésében. Légy strukturált."
)
# Beszélgetés indítása
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Új projektet indítok a weboldalunk újratervezésére. Költségvetés: 50 000 €, határidő: 2026. szeptember."
)
print(f"Beszélgetés azonosító: {response.conversation_id}")
A visszakapott conversation_id a kulcsod ahhoz, hogy később folytathasd ezt a beszélgetést. Tárold el ott, ahol az alkalmazásod később elérheti: egy felhasználói munkamenetben, egy adatbázisban vagy a hozzá kapcsolódó támogatási jegyben.
Beszélgetés folytatása
Egy meglévő beszélgetéshez új üzenet hozzáadásához add át a conversation_id értéket a conversations.append() metódusnak. Kövesd a szálat ebben a példában: a második kérdés nem ismétli meg a költségvetést vagy a határidőt, a harmadik pedig ütemtervet kér anélkül, hogy emlékeztetné az ügynököt arra, hogy weboldal-újratervezésről van szó. Az ügynöknek mégis megvan ez a teljes kontextus.
# Első váltás
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Weboldal-újratervezési projektet indítok. Költségvetés 50 000 €."
)
# Második váltás – az ügynök emlékszik a kontextusra
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Mik a prioritási lépések?"
)
# Harmadik váltás – még mindig ugyanabban a kontextusban
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Készíts ütemtervet az első 3 hónapra."
)
Figyeld meg alaposan, melyik azonosító táplálja az egyes hívásokat: a response2 a response1 azonosítójából indul, a response3 pedig a response2-éből. Ez nem szeszély, hanem az API alapvető mechanizmusa.
A változhatatlansági mechanizmus
A conversations.append() minden egyes hívása egy új conversation_id értéket ad vissza. A régi továbbra is olvasható marad, de a következő hozzáfűzéshez a legfrissebb azonosítót kell használnod.
# Minden append egy új azonosítót ad vissza
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# A folytatáshoz mindig a LEGFRISSEBB azonosítót használd
response4 = client.beta.conversations.append(
conversation_id=id_3, # Nem id_1 vagy id_2
inputs="Adj hozzá ügyféljóváhagyási mérföldköveket."
)
A klasszikus hiba az, amikor a felhasználó megnyitja a szálat, és az eredeti azonosítót menti el az adatbázisba, majd minden egyes üzenetnél változatlanul újra felhasználja. Semmi sem omlik össze: az API normálisan válaszol, de minden kérdés az első váltás kontextusából indul újra, és az ügynököd úgy tűnik, amnéziás lett, miközben semmilyen hiba nem figyelmeztet erre. Mindig írd felül a tárolt azonosítót a válaszban visszakapott új értékkel.
Beszélgetési előzmények olvasása
Bármikor elolvashatod az előzményeket, ami segít mind a hibakeresésben, mind a szál megjelenítésében a felületeden.
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]}...")
Tárolás kezelése
Alapértelmezés szerint a beszélgetéseket a Mistral felhőben tárolja. A store=False paraméter kikapcsolja ezt a viselkedést azoknál a váltásoknál, amelyeket a belső szabályzatod tilt, hogy harmadik fél szerverén maradjanak.
# Ephemeral (mulandó) beszélgetés – semmi sem kerül mentésre
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Bizalmas adatok elemzésre...",
store=False
)
Az kompromisszum illeszkedik a célhoz: a beszélgetés a munkamenet után nem állítható helyre, és az adatok nem maradnak meg a Mistral szerverein. Elveszíted a fent leírt előzmény-lejátszást, és az alkalmazásodnak kell kezelnie a váltások nyomon követését, ha szükséges. Ezt a döntést előre hozd meg, ne utólagos pipaként.
Többkörös beszélgetési minta
Az alábbi vázlat mindent összefoglal, amit fentebb láttál, egy interaktív ciklusban. A lényeg a conversation_id változó, amelyet None-ra inicializálsz: ez dönti el, melyik hívást hajtsd végre – az első körben a start()-ot, utána az append()-ot –, és minden válasz után újraértékelődik, követve a változhatatlansági szabályt.
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="Technikai coach",
description="Coach technikai döntésekhez.",
instructions="Senior technikai coach vagy. Kérdezz, hogy megértsd a kontextust, mielőtt tanácsot adsz."
)
# Beszélgetési ciklus
conversation_id = None
while True:
user_input = input("Te: ")
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"Ügynök: {entry.content}")
Igazítsd a saját kontextusodhoz a kódot: cseréld le az input() hívást a valódi üzenetforrásodra (HTTP kérés, üzenetsor, webhook esemény), és mentsd el a conversation_id értéket ott, ahol az alkalmazásod a következő körben megtalálja.
Főbb megállapítások
- A
conversations.start()létrehoz egy új beszélgetést az első üzenettel - A
conversations.append()hozzáad egy üzenetet egy meglévő beszélgetéshez - Minden
appendhívás egy újconversation_idértéket ad vissza – mindig a legfrissebbet használd - A
store=Falsekikapcsolja a megőrzést a Mistral oldalán érzékeny adatok esetén - Az ügynök megőrzi a teljes beszélgetési kontextust anélkül, hogy neked újra el kellene küldened az előzményeket