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

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

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

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

Поля

Категорії

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

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

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

# Перше збереження
store("project", "project_synapse_status", "v1.4.0 deployed", priority="high")

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

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

• Має бути унікальним у межах (category, mind)
• Використовуйте snake_case
• Префіксуйте категорією для ясності: preference_communication, mistake_npm_version
• Тримайте стабільними — не змінюйте ключі після створення

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

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

# Знайти всі спогади з тегом "docker"
GET /memory/by-tag?tag=docker

# Пошук FTS5 у межах підмножини з тегом
GET /memory/search?q=swarm&tag=docker

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

• 2-5 тегів на спогад (не перетегуйте)
• Нижній регістр для узгодженості
• Використовуйте назви проєктів, тем, технологій
• Теги нечутливі до регістру

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

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

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

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

• user — збережено людиною (через JWT або людський інтерфейс)
• agent — збережено LLM-агентом (через Mind Key)

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

• Верифікацію: спогади user авто-верифікуються, agent — ні
• Впевненість: user за замовчуванням 1.0, agent — 0.7
• Відкликання: /memory/recall позначає неперевірені спогади як «(unverified)»

Верифікація

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

• Спогади user: авто-верифіковані (true)
• Спогади agent: за замовчуванням неперевірені (false)

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

curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \
  -H "Authorization: Bearer YOUR_JWT"

Впевненість

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

• 1.0 — прямо заявлено користувачем
• 0.7 — виведено агентом
• 0.5 — невпевнено, потребує верифікації
• 0.0 — прямо сумнівно

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

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

Термін дії

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

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

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

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

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

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

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

Mind: Michael's Mind
Memories: 12 total (10 verified, 2 unverified)

[001] identity (CRITICAL) [verified]
  user_name
  Michael Schäfer
  Tags: person, identity

[002] preference (HIGH) [verified]
  communication_style
  Prefers concise technical responses
  Tags: communication

[003] project (HIGH) [unverified]
  synapse_status
  v1.5.0 deployed, working on v1.6.0 docs
  Tags: synapse, deployment

...

• Сортовано за пріоритетом (critical → low), потім за новизною
• Неперевірені спогади позначено [unverified]
• Теги включено для контексту
• Звичайний текст (не потрібен розбір JSON)

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

• Memory API
• Найкращі практики роботи з пам'яттю
• Пошук FTS5