Память агента

Долгосрочная память позволяет агентам сохранять и использовать информацию между разными диалогами. Агент может запоминать предпочтения пользователей, важные факты и контекст, который пригодится в будущих разговорах.

Принцип работы

Память хранится в виде отдельных записей (фактов), каждая из которых состоит из:

Поле	Описание	Пример
Область (namespace)	Уровень доступности факта	user, project
Ключ (key)	Идентификатор факта	favorite_color, company_name
Значение (value)	Содержимое факта (текст или JSON)	"синий", {"name": "ООО Рога"}
Описание (description)	Необязательное пояснение	Любимый цвет клиента

Включение памяти

1. Откройте страницу редактирования агента.
2. В правой панели раскройте секцию Долгосрочная память.
3. Включите переключатель Включить память.
4. Настройте нужные области (scopes).

После включения агент автоматически получает набор инструментов для работы с памятью.

Области памяти (Scopes)

Области определяют, кому доступны сохранённые факты. Можно включить одновременно несколько областей.

Диалог (thread)

• Включена по умолчанию при активации памяти.
• Факты доступны только в рамках текущего разговора.
• Подходит для временной информации, актуальной в одном диалоге.
• Пример: текущая тема обсуждения, промежуточные результаты.

Пользователь (user)

• Личная память, привязанная к конкретному пользователю.
• Доступна во всех разговорах этого пользователя.
• Подходит для персональных предпочтений и профиля клиента.
• Пример: имя, язык, часовой пояс, предпочтения.

Проект (project)

• Общая память для всей команды проекта.
• Доступна всем агентам и пользователям проекта.
• Подходит для общих знаний и настроек проекта.
• Пример: правила обработки запросов, актуальные акции.

Организация (organization)

• Память на уровне всей организации.
• Доступна во всех проектах организации.
• Подходит для корпоративных знаний.
• Пример: контакты компании, общая политика обслуживания.

Совет

Для персонализированного обслуживания клиентов включите области «Пользователь» и «Организация». Агент будет запоминать индивидуальные предпочтения каждого клиента и использовать общие корпоративные знания. Подробнее об организации работы: Создание агента.

Инструменты памяти

При включении памяти агент получает четыре инструмента:

save_memory

Сохраняет новый факт или обновляет существующий.

Агент использует этот инструмент автоматически, когда пользователь сообщает важную информацию. Например, если пользователь говорит «Меня зовут Иван», агент сохранит key: "name", value: "Иван" в области user.

retrieve_memory

Получает сохранённый факт по ключу.

Агент обязан проверять память перед тем, как ответить «я не знаю». Инструкции в промпте требуют от агента сначала обратиться к памяти.

list_memories

Выводит список всех сохранённых фактов.

Полезно для обзора всей доступной информации о пользователе или в текущем контексте.

delete_memory

Удаляет факт из памяти.

Используется, когда информация устарела или пользователь попросил забыть что-то.

Примечание

По умолчанию инструменты памяти работают с областью user. Агент автоматически получает инструкции о доступных областях и использует подходящую.

Управление хранилищем памяти

Платформа предоставляет интерфейс для просмотра и управления всеми записями памяти.

Доступ к хранилищу

1. Перейдите в раздел Текстовые агенты > Память.
2. Откроется таблица со всеми записями памяти проекта.

Таблица записей

Колонка	Описание
Область	Цветной тег с областью: Диалог (синий), Пользователь (зелёный), Проект (оранжевый), Организация (фиолетовый)
Ключ	Идентификатор факта
Значение	Содержимое факта
Обновлено	Дата и время последнего изменения
Действия	Кнопки редактирования и удаления

Поиск и фильтрация

• Поиск по ключу — введите текст в поле поиска и нажмите Enter или кнопку «Найти».
• Фильтр по области — выберите область из выпадающего списка (Диалог, Пользователь, Проект, Организация).
• Кнопка Сбросить очищает фильтры и показывает все записи.

Создание записи вручную

1. Нажмите кнопку Память в правом верхнем углу.
2. В модальном окне заполните:
   • Область памяти — выберите из списка.
   • Ключ — например, favorite_color или company_policy.
   • Значение — текст или JSON-объект.
   • Описание — необязательное пояснение.
3. Нажмите Добавить.

Совет

Можно предварительно заполнить память ключевой информацией (контакты компании, правила обслуживания) до того, как агент начнёт работать с пользователями.

Редактирование записи

1. Нажмите кнопку редактирования (иконка карандаша) в строке записи, или выберите Редактировать из контекстного меню (правый клик).
2. В модальном окне измените значение или описание.
3. Нажмите Сохранить.

Примечание

Область и ключ записи нельзя изменить после создания. Если нужно изменить ключ — удалите запись и создайте новую.

Удаление записей

• Одна запись: нажмите кнопку удаления в строке или выберите Удалить из контекстного меню.
• Несколько записей: выделите чекбоксами нужные записи и нажмите Удалить выбранные в панели действий.

Перед удалением система запросит подтверждение.

Типы и классификация памяти

Каждая запись памяти имеет внутреннюю классификацию:

Тип памяти (memory_type)

Тип	Описание
semantic	Знания и факты (имя, предпочтения, правила)
episodic	Конкретные события и опыт
procedural	Процедуры и алгоритмы действий

Источник (source)

Источник	Описание
explicit	Пользователь явно сообщил информацию
extracted	Агент извлёк информацию из контекста
manual	Запись создана вручную через интерфейс
system	Системная запись

Уровень уверенности (confidence)

Числовое значение от 0 до 1, показывающее, насколько надёжна информация. По умолчанию — 1.0.

Практические сценарии

Персонализация клиентского обслуживания

Включите области user и organization. Агент будет:

• Запоминать имя, предпочтения и историю обращений каждого клиента.
• Использовать общие корпоративные знания (правила, акции).
• Обращаться к клиенту по имени в последующих разговорах.

Общая база знаний команды

Включите область project. Агент будет:

• Накапливать знания, полезные для всей команды.
• Делать информацию доступной для всех агентов проекта.

Временный контекст диалога

Включите только область thread. Агент будет:

• Запоминать промежуточные результаты в рамках одного разговора.
• Не загрязнять долгосрочную память временными данными.