{"title":"Model pamięci","slug":"memory-model","category":"concepts","summary":"Jak ustrukturyzowane są wspomnienia — kategorie, klucze, tagi, priorytety, źródła, weryfikacja.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":693,"read_minutes":3,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Model pamięci\n\nModel pamięci Synapse jest zaprojektowany dla agentów LLM — na tyle\nustrukturyzowany, by zapewnić niezawodne przypominanie, na tyle elastyczny, by\npasował do każdej domeny.\n\n## Anatomia wspomnienia\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## Pola\n\n| Pole | Typ | Wymagane | Opis |\n|-------|------|----------|-------------|\n| `id` | string | auto | Unikalny identyfikator (mem_xxx) |\n| `category` | enum | ✅ | Jedna z 8 kategorii |\n| `key` | string | ✅ | Stabilny identyfikator (używany do aktualizacji) |\n| `content` | string | ✅ | Treść wspomnienia (dowolny tekst) |\n| `tags` | string[] | – | Do wyszukiwania i filtrowania |\n| `priority` | enum | – | low, normal, high, critical (domyślnie: normal) |\n| `source` | enum | auto | user, agent (kto zapisał) |\n| `verified` | bool | auto | Czy człowiek to zweryfikował? |\n| `confidence` | float | – | 0.0-1.0 (domyślnie: 1.0 dla użytkownika, 0.7 dla agenta) |\n| `expires_at` | timestamp | – | Kiedy zapomnieć to wspomnienie |\n| `mind_id` | string | auto | Do którego umysłu należy |\n| `created_at` | timestamp | auto | Pierwszy zapis |\n| `updated_at` | timestamp | auto | Ostatnia modyfikacja |\n\n## Kategorie\n\nOsiem kategorii pokrywa typowe przypadki użycia agentów LLM:\n\n| Kategoria | Przeznaczenie | Przykładowa treść |\n|----------|---------|-----------------|\n| `identity` | Kim jest użytkownik | „User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Preferencje użytkownika | „Prefers concise technical responses\" |\n| `fact` | Weryfikowalne fakty | „Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | Status projektu | „Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | Umiejętności użytkownika | „Advanced Python, 10+ years\" |\n| `mistake` | Błędy z przeszłości | „Forgot to bump npm version — CI failed\" |\n| `context` | Kontekst sesji | „Currently reviewing PR #42\" |\n| `note` | Różne notatki | „Try Redis for caching next sprint\" |\n\n## Klucze: stabilne identyfikatory\n\nPole `key` jest kluczowe — to sposób aktualizacji wspomnień bez tworzenia\nduplikatów.\n\n```python\n# Pierwszy zapis\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Aktualizacja tym samym kluczem (nadpisuje, nie duplikuje)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**Zasady kluczy:**\n\n- Musi być unikalny w obrębie (kategoria, umysł)\n- Używać `snake_case`\n- Prefiksować kategorią dla jasności: `preference_communication`, `mistake_npm_version`\n- Utrzymywać stabilność — nie zmieniać kluczy po utworzeniu\n\n## Tagi: do wyszukiwania\n\nTagi umożliwiają szybkie filtrowanie i wyszukiwanie:\n\n```bash\n# Znalezienie wszystkich wspomnień z tagiem „docker\"\nGET /memory/by-tag?tag=docker\n\n# Wyszukiwanie FTS5 w obrębie otagowanego podzbioru\nGET /memory/search?q=swarm&tag=docker\n```\n\n**Najlepsze praktyki tagowania:**\n\n- 2-5 tagów na wspomnienie (bez przesady)\n- Małe litery dla spójności\n- Używać nazw projektów, tematów, technologii\n- Tagi są niewrażliwe na wielkość liter\n\n## Poziomy priorytetu\n\n| Priorytet | Kiedy stosować | Zachowanie recall |\n|----------|-------------|-----------------|\n| `critical` | Tożsamość, kwestie prawne, nieodwracalne | Zawsze na górze recall |\n| `high` | Aktywne projekty, kluczowe preferencje | Wyeksponowane w recall |\n| `normal` | Większość wspomnień (domyślny) | Standardowa kolejność recall |\n| `low` | Efemeryczne, warto wiedzieć | Mogą zostać podsumowane |\n\n`/memory/recall` sortuje po priorytecie (krytyczne najpierw), a następnie po\naktualności.\n\n## Źródło: użytkownik czy agent\n\nWspomnienia są oznaczane `source`:\n\n- `user` — zapisane przez człowieka (przez JWT lub interfejs ludzki)\n- `agent` — zapisane przez agenta LLM (przez Mind Key)\n\nTo wpływa na:\n\n- **Weryfikację:** wspomnienia `user` są automatycznie weryfikowane, `agent` — nie\n- **Pewność:** `user` domyślnie 1.0, `agent` 0.7\n- **Recall:** `/memory/recall` oznacza niezweryfikowane wspomnienia jako „(unverified)\"\n\n> [!NOTE]\n> Należy podchodzić do wspomnień ze źródła `agent` z odpowiednim sceptycyzmem. Mogą\n> być wnioskowane lub zakładane, a nie bezpośrednio zadeklarowane przez użytkownika.\n\n## Weryfikacja\n\nFlaga `verified` wskazuje, że człowiek potwierdził wspomnienie:\n\n- Wspomnienia `user`: automatycznie zweryfikowane (`true`)\n- Wspomnienia `agent`: domyślnie niezweryfikowane (`false`)\n\nWeryfikacja wspomnień:\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> Weryfikacja wymaga JWT (autoryzacja człowieka), a nie Mind Key (autoryzacja\n> agenta). Zapewnia to, że tylko ludzie mogą oznaczać wspomnienia jako zweryfikowane.\n\n## Pewność\n\nPole `confidence` (0.0-1.0) wskazuje, jak wiarygodne jest wspomnienie:\n\n- 1.0 — bezpośrednio zadeklarowane przez użytkownika\n- 0.7 — wnioskowane przez agenta\n- 0.5 — niepewne, wymaga weryfikacji\n- 0.0 — wprost wątpliwe\n\nUstawianie pewności przy zapisie:\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## Wygaśnięcie\n\nDla wspomnień wrażliwych czasowo należy ustawić `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\nWygasłe wspomnienia nie są zwracane przez `/memory/recall` (ale nadal istnieją w\nbazie). Należy użyć `/memory/expiring?within=7d`, aby zobaczyć wspomnienia\nwygasające wkrótce.\n\n## Cykl życia wspomnienia\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## Zachowanie recall\n\n`GET /memory/recall` zwraca podsumowanie w postaci zwykłego tekstu, zoptymalizowane\ndla kontekstu 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- Posortowane po priorytecie (critical → low), a następnie po aktualności\n- Niezweryfikowane wspomnienia oznaczone `[unverified]`\n- Tagi dołączone dla kontekstu\n- Zwykły tekst (bez parsowania JSON)\n\n## Następne kroki\n\n- [Memory API](/docs/api/memory)\n- [Najlepsze praktyki pamięci](/docs/guides/memory-best-practices)\n- [Wyszukiwanie FTS5](/docs/concepts/fts5-search)\n","content_html":"

Model pamięci

\n

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

\n

Anatomia wspomnienia

\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}

Pola

\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
PoleTypWymaganeOpis
idstringautoUnikalny identyfikator (mem_xxx)
categoryenum✅Jedna z 8 kategorii
keystring✅Stabilny identyfikator (używany do aktualizacji)
contentstring✅Treść wspomnienia (dowolny tekst)
tagsstring[]–Do wyszukiwania i filtrowania
priorityenum–low, normal, high, critical (domyślnie: normal)
sourceenumautouser, agent (kto zapisał)
verifiedboolautoCzy człowiek to zweryfikował?
confidencefloat–0.0-1.0 (domyślnie: 1.0 dla użytkownika, 0.7 dla agenta)
expires_attimestamp–Kiedy zapomnieć to wspomnienie
mind_idstringautoDo którego umysłu należy
created_attimestampautoPierwszy zapis
updated_attimestampautoOstatnia modyfikacja
\n

Kategorie

\n

Osiem kategorii pokrywa typowe przypadki użycia agentów 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
KategoriaPrzeznaczeniePrzykładowa treść
identityKim jest użytkownik„User is Michael Schäfer, software engineer in Berlin"
preferencePreferencje użytkownika„Prefers concise technical responses"
factWeryfikowalne fakty„Office is in Berlin, timezone Europe/Berlin"
projectStatus projektu„Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillUmiejętności użytkownika„Advanced Python, 10+ years"
mistakeBłędy z przeszłości„Forgot to bump npm version — CI failed"
contextKontekst sesji„Currently reviewing PR #42"
noteRóżne notatki„Try Redis for caching next sprint"
\n

Klucze: stabilne identyfikatory

\n

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

\n
# Pierwszy zapis\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Aktualizacja tym samym kluczem (nadpisuje, nie duplikuje)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Zasady kluczy:

\n\n

Tagi: do wyszukiwania

\n

Tagi umożliwiają szybkie filtrowanie i wyszukiwanie:

\n
# Znalezienie wszystkich wspomnień z tagiem „docker"\nGET /memory/by-tag?tag=docker\n\n# Wyszukiwanie FTS5 w obrębie otagowanego podzbioru\nGET /memory/search?q=swarm&tag=docker

Najlepsze praktyki tagowania:

\n\n

Poziomy priorytetu

\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
PriorytetKiedy stosowaćZachowanie recall
criticalTożsamość, kwestie prawne, nieodwracalneZawsze na górze recall
highAktywne projekty, kluczowe preferencjeWyeksponowane w recall
normalWiększość wspomnień (domyślny)Standardowa kolejność recall
lowEfemeryczne, warto wiedziećMogą zostać podsumowane
\n

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

\n

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

\n

Wspomnienia są oznaczane source:

\n\n

To wpływa na:

\n\n
Należy podchodzić do wspomnień ze źródła `agent` z odpowiednim sceptycyzmem. Mogą\nbyć wnioskowane lub zakładane, a nie bezpośrednio zadeklarowane przez użytkownika.

Weryfikacja

\n

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

\n\n

Weryfikacja wspomnień:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
Weryfikacja wymaga JWT (autoryzacja człowieka), a nie Mind Key (autoryzacja\nagenta). Zapewnia to, że tylko ludzie mogą oznaczać wspomnienia jako zweryfikowane.

Pewność

\n

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

\n\n

Ustawianie pewności przy zapisie:

\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}

Wygaśnięcie

\n

Dla wspomnień wrażliwych czasowo należy ustawić 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}

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

\n

Cykl życia wspomnienia

\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        └──────────┘ └──────────┘ └──────────┘

Zachowanie recall

\n

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

Następne kroki

\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"]}