Премини към основното съдържание
Български— Изберете език
Меню

Разговори с постоянна памет

Урок 5 от 18 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Състояние, което се запазва между обмените
  2. Стартиране на разговор
  3. Продължаване на разговор
  4. Механизмът на неизменността
  5. Четене на историята на разговора
  6. Управление на съхранението
  7. Шаблон за разговор с много реплики
  8. Ключови изводи

Урокът е актуализиран на 3 ноември 2026 г. въз основа на mistralai SDK 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 за чувствителни данни
  • Агентът запазва пълния контекст на разговора, без да се налага да изпращате отново историята