# Модель памяти
SUMMARY: Как структурированы воспоминания — категории, ключи, теги, приоритеты, источники, верификация.

Модель памяти
Модель памяти Synapse разработана для LLM-агентов — достаточно структурирована
для надёжного отзыва, достаточно гибка для любой предметной области.
Анатомия воспоминания
[CODE BLOCK]
Поля
| Поле | Тип | Обязательное | Описание |
|-------|------|----------|-------------|
|  | string | авто | Уникальный ID (memxxx) |
|  | enum | ✅ | Одна из 8 категорий |
|  | string | ✅ | Стабильный идентификатор (используется для обновлений) |
|  | string | ✅ | Содержимое памяти (любой текст) |
|  | string[] | – | Для поиска и фильтрации |
|  | enum | – | low, normal, high, critical (по умолчанию: normal) |
|  | enum | авто | user, agent (кто сохранил) |
|  | bool | авто | Проверил ли человек? |
|  | float | – | 0.0 до 1.0 (по умолчанию: 1.0 для user, 0.7 для agent) |
|  | timestamp | – | Когда забыть это воспоминание |
|  | string | авто | Какому mind принадлежит |
|  | timestamp | авто | Первый раз сохранено |
|  | timestamp | авто | Последнее изменение |
Категории
Восемь категорий покрывают типичные сценарии LLM-агентов:
| Категория | Назначение | Пример содержимого |
|----------|---------|-----------------|
|  | Кто пользователь | «User is Michael Schäfer, software engineer in Berlin» |
|  | Предпочтения пользователя | «Prefers concise technical responses» |
|  | Проверяемые факты | «Office is in Berlin, timezone Europe/Berlin» |
|  | Статус проекта | «Synapse v1.5.0 deployed, working on v1.6.0 docs» |
|  | Навыки пользователя | «Advanced Python, 10+ years» |
|  | Прошлые ошибки | «Forgot to bump npm version — CI failed» |
|  | Контекст сессии | «Currently reviewing PR #42» |
|  | Прочие заметки | «Try Redis for caching next sprint» |
Ключи: стабильные идентификаторы
Поле  критически важно — с его помощью вы обновляете воспоминания,
не создавая дубликатов.
[CODE BLOCK]
Правила ключей:
- Должен быть уникален в рамках (category, mind)
- Используйте 
- Добавляйте префикс категории для ясности: , 
- Сохраняйте стабильность — не меняйте ключи после создания
Теги: для поиска
Теги обеспечивают быструю фильтрацию и поиск:
[CODE BLOCK]
Лучшие практики тегов:
- 2–5 тегов на воспоминание (не перегружайте)
- Нижний регистр для единообразия
- Используйте названия проектов, темы, технологии
- Теги нечувствительны к регистру
Уровни приоритета
| Приоритет | Когда использовать | Поведение при отзыве |
|----------|-------------|-----------------|
|  | Идентичность, юридическое, необратимое | Всегда наверху отзыва |
|  | Активные проекты, ключевые предпочтения | Заметно в отзыве |
|  | Большинство воспоминаний (по умолчанию) | Стандартный порядок отзыва |
|  | Эфемерное, желательно знать | Может быть суммаризировано |
 сортирует по приоритету (сначала critical), затем по свежести.
Источник: user против agent
У воспоминаний есть тег :
-  — сохранено человеком (через JWT или человеко-ориентированный UI)
-  — сохранено LLM-агентом (через Mind Key)
Это влияет на:
- Верификацию: воспоминания  авто-верифицируются,  — нет
- Уверенность: для  по умолчанию 1.0, для  — 0.7
- Отзыв:  помечает неверифицированные воспоминания как «(unverified)»
> [!NOTE]
> Относитесь к воспоминаниям с источником  с должным скепсисом. Они могут
> быть выведены или предполагаться, а не прямо заявлены пользователем.
Верификация
Флаг  указывает, что человек подтвердил воспоминание:
- Воспоминания : авто-верифицированы ()
- Воспоминания : по умолчанию неверифицированы ()
Верификация через:
[CODE BLOCK]
> [!NOTE]
> Верификация требует JWT (человеческая аутентификация), а не Mind Key
> (агентская аутентификация). Это гарантирует, что только люди могут
> помечать воспоминания как верифицированные.
Уверенность
Поле  (от 0.0 до 1.0) указывает, насколько надёжно воспоминание:
- 1.0 — прямо заявлено пользователем
- 0.7 — выведено агентом
- 0.5 — неопределённое, требует проверки
- 0.0 — явно сомнительное
Устанавливайте confidence при сохранении:
[CODE BLOCK]
Истечение срока
Устанавливайте  для чувствительных ко времени воспоминаний:
[CODE BLOCK]
Истёкшие воспоминания не возвращаются  (но остаются в БД).
Используйте , чтобы увидеть воспоминания, истекающие скоро.
Жизненный цикл памяти
[CODE BLOCK]
Поведение отзыва
 возвращает простое текстовое резюме, оптимизированное
для контекста LLM:
[CODE BLOCK]
- Сортировка по приоритету (critical → low), затем по свежести
- Неверифицированные воспоминания помечены 
- Теги включены для контекста
- Простой текст (разбор JSON не требуется)
Следующие шаги
- Memory API
- Лучшие практики работы с памятью
- FTS5-поиск