Разговори с постоянна памет
На тази страница
Урокът е актуализиран на 3 ноември 2026 г. въз основа на
mistralaiSDK 3.7.0: извличайте историята на разговора (неговитеentries) чрезclient.beta.conversations.get_history; методътretrieveне съществува, аgetвръща само метаданни за разговора. Източник: client-python.
Състояние, което се запазва между обмените
Едно от основните предимства на Agents API пред Chat Completions е постоянството на разговора. Вече не е необходимо ръчно да управлявате историята на съобщенията – Mistral се грижи за това от страната на сървъра. По-конкретно, списъкът с речници, който преди натрупвахте в променлива, съкращавахте при препълване на контекста и възстановявахте при всяко рестартиране на процеса, изчезва от кода Ви. Трябва да проследявате само едно нещо: идентификатор. Този идентификатор следва правило, което обърква всеки при първия му проект.
Стартиране на разговор
Методът conversations.start() създава нов разговор и изпраща първото съобщение. Следващият пример също така създава агента, който ще го изпълни, и му предоставя контекст на проекта, към който можете да се обръщате в продължение на няколко реплики.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Create an agent
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."
)
# Start the conversation
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}")
Върнатият conversation_id е Вашият ключ за продължаване на този разговор по-късно. Съхранете го на място, откъдето приложението Ви може да го извлече: в потребителска сесия, база данни или свързания с него билет за поддръжка.
Продължаване на разговор
За да добавите съобщение към съществуващ разговор, предайте conversation_id на conversations.append(). Следвайте нишката в този пример: вторият въпрос не повтаря бюджета или крайния срок, а третият иска график, без да напомня на агента, че става въпрос за редизайн на уебсайт. Въпреки това агентът разполага с целия този контекст.
# First exchange
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="I'm launching a website redesign project. Budget €50K."
)
# Second exchange — the agent remembers the context
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="What are the priority steps?"
)
# Third exchange — still in the same context
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Draft a schedule for the first 3 months."
)
Обърнете внимание кой идентификатор захранва всяко извикване: response2 започва от ID на response1, а response3 – от това на response2. Това не е причуда, а основният механизъм на API.
Механизмът на неизменността
Всяко извикване на conversations.append() връща нов conversation_id. Старият остава достъпен за четене, но трябва да използвате най-новия ID за следващото добавяне.
# Each append returns a new ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Always use the LATEST id to continue
response4 = client.beta.conversations.append(
conversation_id=id_3, # Not id_1 or id_2
inputs="Add client validation milestones."
)
Класическата грешка е да запазите началния идентификатор в базата данни, когато потребителят отвори нишката, и след това да го преизползвате както си е за всяко съобщение. Нищо не се срива: API отговаря нормално, но всеки въпрос рестартира от контекста на първия обмен и агентът Ви изглежда страда от амнезия, без никаква грешка да Ви предупреждава. Винаги презаписвайте съхранения идентификатор с този, върнат в отговора.
Четене на историята на разговора
Можете да четете историята по всяко време, което помага както за отстраняване на грешки, така и за показване на нишката във Вашия интерфейс.
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]}...")
Управление на съхранението
По подразбиране разговорите се съхраняват в облака на Mistral. Параметърът store=False деактивира това поведение за обмени, които Вашата вътрешна политика забранява да остават на сървър на трета страна.
# Ephemeral conversation — nothing is saved
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Confidential data to analyze...",
store=False
)
Компромисът отговаря на целта: разговорът не може да бъде възстановен след края на сесията и данните не се пазят на сървърите на Mistral. Губите възможността за възпроизвеждане на историята, описана по-горе, и Вашето приложение трябва само да се справи с проследяването на обмените, ако е необходимо. Вземете това решение предварително, а не като отметка в последния момент.
Шаблон за разговор с много реплики
Скелетът по-долу прилага всичко казано дотук в интерактивен цикъл. Ключовият момент е променливата conversation_id, инициализирана като None: тя решава кое извикване да се направи – start() при първата реплика, append() след това – и се преназначава след всеки отговор, следвайки правилото за неизменност.
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."
)
# Conversation loop
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}")
Адаптирайте го към Вашия контекст, като замените input() с действителния източник на съобщения – HTTP заявка, съобщение от опашка, събитие от уебхук – и запазвате conversation_id там, където приложението Ви може да го открие при следващата реплика.
Ключови изводи
conversations.start()създава нов разговор с първо съобщениеconversations.append()добавя съобщение към съществуващ разговор- Всяко добавяне връща нов
conversation_id– винаги използвайте най-новия store=Falseдеактивира постоянството от страна на Mistral за чувствителни данни- Агентът запазва пълния контекст на разговора, без да се налага да изпращате отново историята