# Модель пам'яті
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 першими), потім за новизною.
Джерело: користувач проти агента
Спогади позначаються :
-  — збережено людиною (через JWT або людський інтерфейс)
-  — збережено 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 — прямо сумнівно
Встановлюйте впевненість при збереженні:
[CODE BLOCK]
Термін дії
Встановлюйте  для спогадів, чутливих до часу:
[CODE BLOCK]
Спогади з минулим терміном не повертаються  (але все ще
існують у БД). Використовуйте , щоб побачити
спогади, термін яких скоро закінчується.
Життєвий цикл спогаду
[CODE BLOCK]
Поведінка відкликання
 повертає текстове резюме, оптимізоване для контексту LLM:
[CODE BLOCK]
- Сортовано за пріоритетом (critical → low), потім за новизною
- Неперевірені спогади позначено 
- Теги включено для контексту
- Звичайний текст (не потрібен розбір JSON)
Наступні кроки
- Memory API
- Найкращі практики роботи з пам'яттю
- Пошук FTS5