{"title":"Модель пам'яті","slug":"memory-model","category":"concepts","summary":"Як структуровані спогади — категорії, ключі, теги, пріоритети, джерела, верифікація.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":682,"read_minutes":3,"lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Модель пам'яті\n\nМодель пам'яті Synapse розроблена для LLM-агентів — достатньо структурована для\nнадійного відкликання, достатньо гнучка для будь-якої предметної області.\n\n## Анатомія спогаду\n\n```json\n{\n \"id\": \"mem_abc123\",\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed on vps1. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"v1.5.0\"],\n \"priority\": \"high\",\n \"source\": \"agent\",\n \"verified\": false,\n \"confidence\": 0.85,\n \"expires_at\": null,\n \"mind_id\": \"m_xyz789\",\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n## Поля\n\n| Поле | Тип | Обов'язкове | Опис |\n|-------|------|----------|-------------|\n| `id` | string | авто | Унікальний ID (mem_xxx) |\n| `category` | enum | ✅ | Одна з 8 категорій |\n| `key` | string | ✅ | Стабільний ідентифікатор (для оновлень) |\n| `content` | string | ✅ | Вміст спогаду (будь-який текст) |\n| `tags` | string[] | – | Для пошуку та фільтрації |\n| `priority` | enum | – | low, normal, high, critical (за замовчуванням: normal) |\n| `source` | enum | авто | user, agent (хто зберіг) |\n| `verified` | bool | авто | Чи верифікувала це людина? |\n| `confidence` | float | – | 0.0 до 1.0 (за замовчуванням: 1.0 для user, 0.7 для agent) |\n| `expires_at` | timestamp | – | Коли забути цей спогад |\n| `mind_id` | string | авто | Якому mind-у належить |\n| `created_at` | timestamp | авто | Перше збереження |\n| `updated_at` | timestamp | авто | Остання зміна |\n\n## Категорії\n\nВісім категорій охоплюють типові варіанти використання LLM-агентів:\n\n| Категорія | Призначення | Приклад вмісту |\n|----------|---------|-----------------|\n| `identity` | Ким є користувач | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Уподобання користувача | \"Prefers concise technical responses\" |\n| `fact` | Перевірювані факти | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | Статус проєкту | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | Навички користувача | \"Advanced Python, 10+ years\" |\n| `mistake` | Минулі помилки | \"Forgot to bump npm version — CI failed\" |\n| `context` | Контекст сесії | \"Currently reviewing PR #42\" |\n| `note` | Різні нотатки | \"Try Redis for caching next sprint\" |\n\n## Ключі: стабільні ідентифікатори\n\nПоле `key` є критичним — воно дозволяє оновлювати спогади без створення\nдублікатів.\n\n```python\n# Перше збереження\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Оновлення з тим самим ключем (перезаписує, не дублює)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**Правила ключів:**\n\n- Має бути унікальним у межах (category, mind)\n- Використовуйте `snake_case`\n- Префіксуйте категорією для ясності: `preference_communication`, `mistake_npm_version`\n- Тримайте стабільними — не змінюйте ключі після створення\n\n## Теги: для пошуку\n\nТеги забезпечують швидку фільтрацію та пошук:\n\n```bash\n# Знайти всі спогади з тегом \"docker\"\nGET /memory/by-tag?tag=docker\n\n# Пошук FTS5 у межах підмножини з тегом\nGET /memory/search?q=swarm&tag=docker\n```\n\n**Найкращі практики тегів:**\n\n- 2-5 тегів на спогад (не перетегуйте)\n- Нижній регістр для узгодженості\n- Використовуйте назви проєктів, тем, технологій\n- Теги нечутливі до регістру\n\n## Рівні пріоритету\n\n| Пріоритет | Коли використовувати | Поведінка відкликання |\n|----------|-------------|-----------------|\n| `critical` | Ідентичність, юридична інформація, незворотне | Завжди на початку відкликання |\n| `high` | Активні проєкти, ключові уподобання | Помітне у відкликанні |\n| `normal` | Більшість спогадів (за замовчуванням) | Стандартний порядок відкликання |\n| `low` | Ефемерне, корисно знати | Може бути сумаризовано |\n\n`/memory/recall` сортує за пріоритетом (critical першими), потім за новизною.\n\n## Джерело: користувач проти агента\n\nСпогади позначаються `source`:\n\n- `user` — збережено людиною (через JWT або людський інтерфейс)\n- `agent` — збережено LLM-агентом (через Mind Key)\n\nЦе впливає на:\n\n- **Верифікацію:** спогади `user` авто-верифікуються, `agent` — ні\n- **Впевненість:** `user` за замовчуванням 1.0, `agent` — 0.7\n- **Відкликання:** `/memory/recall` позначає неперевірені спогади як «(unverified)»\n\n> [!NOTE]\n> Ставтеся до спогадів із джерелом `agent` зі здоровим скептицизмом. Вони можуть\n> бути виведені або припущені, а не прямо заявлені користувачем.\n\n## Верифікація\n\nПрапорець `verified` вказує, що людина підтвердила спогад:\n\n- Спогади `user`: авто-верифіковані (`true`)\n- Спогади `agent`: за замовчуванням неперевірені (`false`)\n\nВерифікуйте спогади через:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n> [!NOTE]\n> Верифікація потребує JWT (автентифікація людини), а не Mind Key (автентифікація\n> агента). Це гарантує, що лише люди можуть позначати спогади як перевірені.\n\n## Впевненість\n\nПоле `confidence` (0.0 до 1.0) вказує, наскільки надійним є спогад:\n\n- 1.0 — прямо заявлено користувачем\n- 0.7 — виведено агентом\n- 0.5 — невпевнено, потребує верифікації\n- 0.0 — прямо сумнівно\n\nВстановлюйте впевненість при збереженні:\n\n```json\n{\n \"category\": \"preference\",\n \"key\": \"prefers_dark_mode\",\n \"content\": \"User seems to prefer dark mode (based on their IDE screenshots)\",\n \"confidence\": 0.5,\n \"source\": \"agent\"\n}\n```\n\n## Термін дії\n\nВстановлюйте `expires_at` для спогадів, чутливих до часу:\n\n```json\n{\n \"category\": \"context\",\n \"key\": \"current_meeting_topic\",\n \"content\": \"Discussing Q3 roadmap\",\n \"expires_at\": \"2026-06-28T00:00:00Z\"\n}\n```\n\nСпогади з минулим терміном не повертаються `/memory/recall` (але все ще\nіснують у БД). Використовуйте `/memory/expiring?within=7d`, щоб побачити\nспогади, термін яких скоро закінчується.\n\n## Життєвий цикл спогаду\n\n```\n ┌─────────────────┐\n │ Create │\n │ POST /memory │\n └────────┬────────┘\n │\n ▼\n ┌─────────────────┐\n │ Active │ ◀──── PUT /memory/:id (update)\n │ (in recall) │\n └────────┬────────┘\n │\n ┌────────────┼────────────┐\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ Expired │ │ Verified │ │ Deleted │\n │ (in DB) │ │ (flag) │ │ (gone) │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Поведінка відкликання\n\n`GET /memory/recall` повертає текстове резюме, оптимізоване для контексту LLM:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH) [verified]\n communication_style\n Prefers concise technical responses\n Tags: communication\n\n[003] project (HIGH) [unverified]\n synapse_status\n v1.5.0 deployed, working on v1.6.0 docs\n Tags: synapse, deployment\n\n...\n```\n\n- Сортовано за пріоритетом (critical → low), потім за новизною\n- Неперевірені спогади позначено `[unverified]`\n- Теги включено для контексту\n- Звичайний текст (не потрібен розбір JSON)\n\n## Наступні кроки\n\n- [Memory API](/docs/api/memory)\n- [Найкращі практики роботи з пам'яттю](/docs/guides/memory-best-practices)\n- [Пошук FTS5](/docs/concepts/fts5-search)\n","content_html":"

Модель пам'яті

\n

Модель пам'яті Synapse розроблена для LLM-агентів — достатньо структурована для\nнадійного відкликання, достатньо гнучка для будь-якої предметної області.

\n

Анатомія спогаду

\n
{\n  "id": "mem_abc123",\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed on vps1. CI green.",\n  "tags": ["synapse", "deployment", "v1.5.0"],\n  "priority": "high",\n  "source": "agent",\n  "verified": false,\n  "confidence": 0.85,\n  "expires_at": null,\n  "mind_id": "m_xyz789",\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

Поля

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПолеТипОбов'язковеОпис
idstringавтоУнікальний ID (mem_xxx)
categoryenum✅Одна з 8 категорій
keystring✅Стабільний ідентифікатор (для оновлень)
contentstring✅Вміст спогаду (будь-який текст)
tagsstring[]–Для пошуку та фільтрації
priorityenum–low, normal, high, critical (за замовчуванням: normal)
sourceenumавтоuser, agent (хто зберіг)
verifiedboolавтоЧи верифікувала це людина?
confidencefloat–0.0 до 1.0 (за замовчуванням: 1.0 для user, 0.7 для agent)
expires_attimestamp–Коли забути цей спогад
mind_idstringавтоЯкому mind-у належить
created_attimestampавтоПерше збереження
updated_attimestampавтоОстання зміна
\n

Категорії

\n

Вісім категорій охоплюють типові варіанти використання LLM-агентів:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
КатегоріяПризначенняПриклад вмісту
identityКим є користувач"User is Michael Schäfer, software engineer in Berlin"
preferenceУподобання користувача"Prefers concise technical responses"
factПеревірювані факти"Office is in Berlin, timezone Europe/Berlin"
projectСтатус проєкту"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillНавички користувача"Advanced Python, 10+ years"
mistakeМинулі помилки"Forgot to bump npm version — CI failed"
contextКонтекст сесії"Currently reviewing PR #42"
noteРізні нотатки"Try Redis for caching next sprint"
\n

Ключі: стабільні ідентифікатори

\n

Поле key є критичним — воно дозволяє оновлювати спогади без створення\nдублікатів.

\n
# Перше збереження\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Оновлення з тим самим ключем (перезаписує, не дублює)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Правила ключів:

\n\n

Теги: для пошуку

\n

Теги забезпечують швидку фільтрацію та пошук:

\n
# Знайти всі спогади з тегом "docker"\nGET /memory/by-tag?tag=docker\n\n# Пошук FTS5 у межах підмножини з тегом\nGET /memory/search?q=swarm&tag=docker

Найкращі практики тегів:

\n\n

Рівні пріоритету

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПріоритетКоли використовуватиПоведінка відкликання
criticalІдентичність, юридична інформація, незворотнеЗавжди на початку відкликання
highАктивні проєкти, ключові уподобанняПомітне у відкликанні
normalБільшість спогадів (за замовчуванням)Стандартний порядок відкликання
lowЕфемерне, корисно знатиМоже бути сумаризовано
\n

/memory/recall сортує за пріоритетом (critical першими), потім за новизною.

\n

Джерело: користувач проти агента

\n

Спогади позначаються source:

\n\n

Це впливає на:

\n\n
Ставтеся до спогадів із джерелом `agent` зі здоровим скептицизмом. Вони можуть\nбути виведені або припущені, а не прямо заявлені користувачем.

Верифікація

\n

Прапорець verified вказує, що людина підтвердила спогад:

\n\n

Верифікуйте спогади через:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
Верифікація потребує JWT (автентифікація людини), а не Mind Key (автентифікація\nагента). Це гарантує, що лише люди можуть позначати спогади як перевірені.

Впевненість

\n

Поле confidence (0.0 до 1.0) вказує, наскільки надійним є спогад:

\n\n

Встановлюйте впевненість при збереженні:

\n
{\n  "category": "preference",\n  "key": "prefers_dark_mode",\n  "content": "User seems to prefer dark mode (based on their IDE screenshots)",\n  "confidence": 0.5,\n  "source": "agent"\n}

Термін дії

\n

Встановлюйте expires_at для спогадів, чутливих до часу:

\n
{\n  "category": "context",\n  "key": "current_meeting_topic",\n  "content": "Discussing Q3 roadmap",\n  "expires_at": "2026-06-28T00:00:00Z"\n}

Спогади з минулим терміном не повертаються /memory/recall (але все ще\nіснують у БД). Використовуйте /memory/expiring?within=7d, щоб побачити\nспогади, термін яких скоро закінчується.

\n

Життєвий цикл спогаду

\n
                  ┌─────────────────┐\n                  │     Create      │\n                  │  POST /memory   │\n                  └────────┬────────┘\n                           │\n                           ▼\n                  ┌─────────────────┐\n                  │     Active      │ ◀──── PUT /memory/:id (update)\n                  │  (in recall)    │\n                  └────────┬────────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n        ┌──────────┐ ┌──────────┐ ┌──────────┐\n        │ Expired  │ │ Verified │ │ Deleted  │\n        │ (in DB)  │ │ (flag)   │ │ (gone)   │\n        └──────────┘ └──────────┘ └──────────┘

Поведінка відкликання

\n

GET /memory/recall повертає текстове резюме, оптимізоване для контексту LLM:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH) [verified]\n  communication_style\n  Prefers concise technical responses\n  Tags: communication\n\n[003] project (HIGH) [unverified]\n  synapse_status\n  v1.5.0 deployed, working on v1.6.0 docs\n  Tags: synapse, deployment\n\n...
\n

Наступні кроки

\n\n","urls":{"html":"/docs/concepts/memory-model","text":"/docs/concepts/memory-model?format=text","json":"/docs/concepts/memory-model?format=json","llm":"/docs/concepts/memory-model?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}