Model pamięci

Model pamięci Synapse jest zaprojektowany dla agentów LLM — na tyle ustrukturyzowany, by zapewnić niezawodne przypominanie, na tyle elastyczny, by pasował do każdej domeny.

Anatomia wspomnienia

{
  "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..."
}

Pola

Kategorie

Osiem kategorii pokrywa typowe przypadki użycia agentów LLM:

Klucze: stabilne identyfikatory

Pole key jest kluczowe — to sposób aktualizacji wspomnień bez tworzenia duplikatów.

# Pierwszy zapis
store("project", "project_synapse_status", "v1.4.0 deployed", priority="high")

# Aktualizacja tym samym kluczem (nadpisuje, nie duplikuje)
store("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Zasady kluczy:

• Musi być unikalny w obrębie (kategoria, umysł)
• Używać snake_case
• Prefiksować kategorią dla jasności: preference_communication, mistake_npm_version
• Utrzymywać stabilność — nie zmieniać kluczy po utworzeniu

Tagi: do wyszukiwania

Tagi umożliwiają szybkie filtrowanie i wyszukiwanie:

# Znalezienie wszystkich wspomnień z tagiem „docker"
GET /memory/by-tag?tag=docker

# Wyszukiwanie FTS5 w obrębie otagowanego podzbioru
GET /memory/search?q=swarm&tag=docker

Najlepsze praktyki tagowania:

• 2-5 tagów na wspomnienie (bez przesady)
• Małe litery dla spójności
• Używać nazw projektów, tematów, technologii
• Tagi są niewrażliwe na wielkość liter

Poziomy priorytetu

/memory/recall sortuje po priorytecie (krytyczne najpierw), a następnie po aktualności.

Źródło: użytkownik czy agent

Wspomnienia są oznaczane source:

• user — zapisane przez człowieka (przez JWT lub interfejs ludzki)
• agent — zapisane przez agenta LLM (przez Mind Key)

To wpływa na:

• Weryfikację: wspomnienia user są automatycznie weryfikowane, agent — nie
• Pewność: user domyślnie 1.0, agent 0.7
• Recall: /memory/recall oznacza niezweryfikowane wspomnienia jako „(unverified)"

Weryfikacja

Flaga verified wskazuje, że człowiek potwierdził wspomnienie:

• Wspomnienia user: automatycznie zweryfikowane (true)
• Wspomnienia agent: domyślnie niezweryfikowane (false)

Weryfikacja wspomnień:

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

Pewność

Pole confidence (0.0-1.0) wskazuje, jak wiarygodne jest wspomnienie:

• 1.0 — bezpośrednio zadeklarowane przez użytkownika
• 0.7 — wnioskowane przez agenta
• 0.5 — niepewne, wymaga weryfikacji
• 0.0 — wprost wątpliwe

Ustawianie pewności przy zapisie:

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

Wygaśnięcie

Dla wspomnień wrażliwych czasowo należy ustawić expires_at:

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

Wygasłe wspomnienia nie są zwracane przez /memory/recall (ale nadal istnieją w bazie). Należy użyć /memory/expiring?within=7d, aby zobaczyć wspomnienia wygasające wkrótce.

Cykl życia wspomnienia

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

Zachowanie recall

GET /memory/recall zwraca podsumowanie w postaci zwykłego tekstu, zoptymalizowane dla kontekstu 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

...

• Posortowane po priorytecie (critical → low), a następnie po aktualności
• Niezweryfikowane wspomnienia oznaczone [unverified]
• Tagi dołączone dla kontekstu
• Zwykły tekst (bez parsowania JSON)

Następne kroki

• Memory API
• Najlepsze praktyki pamięci
• Wyszukiwanie FTS5