Salt la conținutul principal
Română— Alege o limbă
Meniu

Conversații persistente

Lecția 5 din 18 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. O stare care persistă între schimburi
  2. Inițierea unei conversații
  3. Continuarea unei conversații
  4. Mecanismul de imutabilitate
  5. Citirea istoricului conversației
  6. Gestionarea stocării
  7. Modelul de conversație pe mai multe tururi
  8. Puncte cheie

Lecție actualizată la 3 noiembrie 2026 pe baza SDK mistralai 3.7.0: preluați istoricul unei conversații (elementele sale entries) folosind client.beta.conversations.get_history; metoda retrieve nu există, iar get returnează doar metadatele conversației. Sursă: client-python.

O stare care persistă între schimburi

Unul dintre avantajele majore ale API-ului Agents față de Chat Completions este persistența conversației. Nu mai trebuie să gestionați manual istoricul mesajelor – Mistral se ocupă de acest lucru la nivel de server. Mai exact, lista de dicționare pe care obișnuiți să o acumulați într-o variabilă, să o trunchiați când contextul depășea limita și să o reconstruiți la fiecare repornire a procesului, dispare din codul dumneavoastră. Trebuie doar să urmăriți un singur lucru: un identificator. Iar acel identificator respectă o regulă care îi pune în dificultate pe toți la primul proiect.

Inițierea unei conversații

Metoda conversations.start() creează o nouă conversație și trimite primul mesaj. Exemplul următor creează, de asemenea, agentul care o va executa, apoi îi oferă un context de proiect pe care îl puteți interoga pe parcursul mai multor interacțiuni.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Crearea unui agent
agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Asistent Proiect",
    description="Asistent pentru gestionarea proiectelor.",
    instructions="Ajuți la organizarea și urmărirea proiectelor. Fii structurat."
)

# Inițierea conversației
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Lansez un nou proiect pentru redesignarea site-ului nostru. Buget: 50.000 €, termen limită: septembrie 2026."
)

print(f"ID conversație: {response.conversation_id}")

conversation_id returnat este cheia dumneavoastră pentru a continua această conversație mai târziu. Stocați-l acolo unde aplicația dumneavoastră îl poate recupera: într-o sesiune de utilizator, într-o bază de date sau în tichetul de suport la care se referă.

Continuarea unei conversații

Pentru a adăuga un mesaj unei conversații existente, transmiteți conversation_id către conversations.append(). Urmăriți firul logic în acest exemplu: a doua întrebare nu repetă bugetul sau termenul limită, iar a treia solicită un calendar fără a reaminti agentului că este vorba despre un redesign de site. Cu toate acestea, agentul deține tot acel context.

# Primul schimb
response1 = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Lansez un proiect de redesignare a site-ului. Buget 50.000 €."
)

# Al doilea schimb — agentul își amintește contextul
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Care sunt pașii prioritari?"
)

# Al treilea schimb — tot în același context
response3 = client.beta.conversations.append(
    conversation_id=response2.conversation_id,
    inputs="Redactează un calendar pentru primele 3 luni."
)

Observați cu atenție care identificator alimentează fiecare apel: response2 pornește de la ID-ul lui response1, iar response3 de la cel al lui response2. Aceasta nu este o particularitate ciudată; este mecanismul central al API-ului.

Mecanismul de imutabilitate

Fiecare apel către conversations.append() returnează un nou conversation_id. Cel vechi rămâne accesibil pentru citire, dar trebuie să utilizați cel mai recent ID pentru următoarea operație de adăugare.

# Fiecare append returnează un nou ID
id_1 = response1.conversation_id  # "conv-aaa"
id_2 = response2.conversation_id  # "conv-bbb"
id_3 = response3.conversation_id  # "conv-ccc"

# Utilizați întotdeauna ultimul ID pentru a continua
response4 = client.beta.conversations.append(
    conversation_id=id_3,  # Nu id_1 sau id_2
    inputs="Adaugă etape de validare cu clientul."
)

Greșeala clasică constă în salvarea identificatorului inițial în baza de date când utilizatorul deschide firul de discuție, apoi reutilizarea acestuia ca atare pentru fiecare mesaj. Nimic nu se blochează: API-ul răspunde normal, dar fiecare întrebare repornește de la contextul primului schimb, iar agentul dumneavoastră pare să aibă amnezie, fără nicio eroare care să vă alerteze. Suprascrieți întotdeauna identificatorul stocat cu cel returnat în răspuns.

Citirea istoricului conversației

Puteți citi istoricul în orice moment, ceea ce ajută atât la depanare, cât și la afișarea unui fir de discuție în interfața dumneavoastră.

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]}...")

Gestionarea stocării

Implicit, conversațiile sunt stocate în cloud-ul Mistral. Parametrul store=False dezactivează acest comportament pentru schimburile pe care politica internă a companiei dumneavoastră interzice să fie lăsate pe un server terț.

# Conversație efemeră — nimic nu este salvat
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Date confidențiale de analizat...",
    store=False
)

Compromisul corespunde obiectivului: conversația nu poate fi recuperată după încheierea sesiunii, iar datele nu sunt păstrate pe serverele Mistral. Pierdeți redarea istoricului descrisă mai sus, iar aplicația dumneavoastră trebuie să gestioneze urmărirea schimburilor singură, dacă este necesar. Luați această decizie de la început, nu ca o bifă de ultim moment.

Modelul de conversație pe mai multe tururi

Scheletul de mai jos aplică totul ceea ce am discutat anterior într-o buclă interactivă. Punctul cheie este variabila conversation_id, inițializată cu None: aceasta decide ce apel să facă – start() la primul tur, append() ulterior – și este reatribuită după fiecare răspuns, respectând regula imutabilității.

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="Coach Tehnic",
    description="Coach pentru decizii tehnice.",
    instructions="Ești un coach tehnic senior. Pune întrebări pentru a înțelege contextul înainte de a oferi sfaturi."
)

# Bucla de conversație
conversation_id = None

while True:
    user_input = input("Dumneavoastră: ")
    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}")

Adaptați-l la contextul dumneavoastră înlocuind input() cu sursa reală de mesaje – cerere HTTP, mesaj din coadă, eveniment webhook – și persistând conversation_id acolo unde aplicația dumneavoastră îl poate găsi la următorul tur.

Puncte cheie

  • conversations.start() creează o nouă conversație cu un prim mesaj
  • conversations.append() adaugă un mesaj unei conversații existente
  • Fiecare apel append returnează un nou conversation_id – utilizați-l întotdeauna pe cel mai recent
  • store=False dezactivează persistența din partea Mistral pentru datele sensibile
  • Agentul păstrează întregul context al conversației fără ca dumneavoastră să fie nevoie să retrimiteți istoricul