Conversații persistente
Pe această pagină
Lecție actualizată la 3 noiembrie 2026 pe baza SDK
mistralai3.7.0: preluați istoricul unei conversații (elementele saleentries) folosindclient.beta.conversations.get_history; metodaretrievenu există, iargetreturnează 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 mesajconversations.append()adaugă un mesaj unei conversații existente- Fiecare apel
appendreturnează un nouconversation_id– utilizați-l întotdeauna pe cel mai recent store=Falsedezactivează 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