Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Folyamatos beszélgetések

5. lecke 18 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Állapot, amely megmarad a váltások során
  2. Beszélgetés indítása
  3. Beszélgetés folytatása
  4. A változhatatlansági mechanizmus
  5. Beszélgetési előzmények olvasása
  6. Tárolás kezelése
  7. Többkörös beszélgetési minta
  8. Főbb megállapítások

Lecke frissítve: 2026. november 3. a mistralai SDK 3.7.0 verziója alapján: a beszélgetés előzményeinek (az entries lista) lekérdezéséhez használd a client.beta.conversations.get_history metódust; a retrieve nem létezik, a get pedig 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 append hívás egy új conversation_id értéket ad vissza – mindig a legfrissebbet használd
  • A store=False kikapcsolja 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