{"title":"Minnesmodellen","slug":"memory-model","category":"concepts","summary":"Hur minnen är strukturerade — kategorier, nycklar, taggar, prioriteringar, källor, verifiering.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":669,"read_minutes":3,"lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Minnesmodellen\n\nSynapses minnesmodell är utformad för LLM-agenter — tillräckligt strukturerad\nför pålitlig återkallning, tillräckligt flexibel för alla domäner.\n\n## Minnesanatomi\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## Fält\n\n| Fält | Typ | Obligatorisk | Beskrivning |\n|-------|------|----------|-------------|\n| `id` | sträng | auto | Unikt ID (mem_xxx) |\n| `category` | enum | ✅ | En av 8 kategorier |\n| `key` | sträng | ✅ | Stabil identifierare (används för uppdateringar) |\n| `content` | sträng | ✅ | Minnesinnehållet (valfri text) |\n| `tags` | sträng[] | – | För sökning och filtrering |\n| `priority` | enum | – | low, normal, high, critical (standard: normal) |\n| `source` | enum | auto | user, agent (vem som lagrade det) |\n| `verified` | bool | auto | Har en människa verifierat detta? |\n| `confidence` | flyttal | – | 0.0 till 1.0 (standard: 1.0 för user, 0.7 för agent) |\n| `expires_at` | tidsstämpel | – | När minnet ska glömmas |\n| `mind_id` | sträng | auto | Vilken mind som äger detta |\n| `created_at` | tidsstämpel | auto | Först lagrad |\n| `updated_at` | tidsstämpel | auto | Senast ändrad |\n\n## Kategorier\n\nÅtta kategorier täcker vanliga användningsområden för LLM-agenter:\n\n| Kategori | Syfte | Exempel på innehåll |\n|----------|---------|-----------------|\n| `identity` | Vem användaren är | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Användarinställningar | \"Prefers concise technical responses\" |\n| `fact` | Verifierbara fakta | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | Projektstatus | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | Användarens färdigheter | \"Advanced Python, 10+ years\" |\n| `mistake` | Tidigare fel | \"Forgot to bump npm version — CI failed\" |\n| `context` | Sessionskontext | \"Currently reviewing PR #42\" |\n| `note` | Diverse anteckningar | \"Try Redis for caching next sprint\" |\n\n## Nycklar: stabila identifierare\n\nFältet `key` är kritiskt — det är så ni uppdaterar minnen utan att skapa\ndubbletter.\n\n```python\n# First store\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**Nyckelregler:**\n\n- Måste vara unik inom (category, mind)\n- Använd `snake_case`\n- Prefixa med kategori för tydlighet: `preference_communication`, `mistake_npm_version`\n- Håll stabil — ändra inte nycklar efter skapandet\n\n## Taggar: för sökning\n\nTaggar möjliggör snabb filtrering och sökning:\n\n```bash\n# Find all memories with tag \"docker\"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker\n```\n\n**Bästa praxis för taggar:**\n\n- 2–5 taggar per minne (överätta inte)\n- Gemener för konsekvens\n- Använd projektnamn, ämnen, tekniker\n- Taggar är skiftesokänsliga\n\n## Prioriteringsnivåer\n\n| Prioritering | När den ska användas | Återkallningsbeteende |\n|----------|-------------|-----------------|\n| `critical` | Identitet, juridik, oåterkalleligt | Alltid högst upp i återkallning |\n| `high` | Aktiva projekt, nyckelinställningar | Framträdande i återkallning |\n| `normal` | De flesta minnen (standard) | Standardordning för återkallning |\n| `low` | Efemärt, trevligt att veta | Kan sammanfattas |\n\n`/memory/recall` sorterar efter prioritet (kritisk först), sedan efter aktualitet.\n\n## Källa: användare vs agent\n\nMinnen taggas med `source`:\n\n- `user` — lagrad av en människa (via JWT eller mänskligt gränssnitt)\n- `agent` — lagrad av en LLM-agent (via Mind Key)\n\nDetta påverkar:\n\n- **Verifiering**: `user`-minnen verifieras automatiskt, `agent`-minnen inte\n- **Konfidens**: `user` standard 1.0, `agent` 0.7\n- **Återkallning**: `/memory/recall` markerar overifierade minnen med \"(unverified)\"\n\n> [!NOTE]\n> Behandla `agent`-källade minnen med lämplig skepsis. De kan vara härledda\n> eller antagna snarare än direkt angivna av användaren.\n\n## Verifiering\n\nFlaggan `verified` indikerar att en människa har bekräftat minnet:\n\n- `user`-minnen: auto-verifierade (`true`)\n- `agent`-minnen: standard overifierade (`false`)\n\nVerifiera minnen via:\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> Verifiering kräver JWT (mänsklig autentisering), inte Mind Key\n> (agent-autentisering). Detta säkerställer att endast människor kan markera\n> minnen som verifierade.\n\n## Konfidens\n\nFältet `confidence` (0.0 till 1.0) indikerar hur pålitligt minnet är:\n\n- 1.0 — direkt angivet av användare\n- 0.7 — härlett av agent\n- 0.5 — osäkert, behöver verifiering\n- 0.0 — uttryckligen tvivelaktigt\n\nSätt konfidens vid lagring:\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## Utgång\n\nSätt `expires_at` för tidskänsliga minnen:\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\nUtgångna minnen returneras inte av `/memory/recall` (men finns fortfarande i DB).\nAnvänd `/memory/expiring?within=7d` för att se minnen som löper ut snart.\n\n## Minneslivscykel\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## Återkallningsbeteende\n\n`GET /memory/recall` returnerar en oformaterad textsammanfattning optimerad\nför LLM-kontext:\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- Sorterat efter prioritet (kritisk → låg), sedan efter aktualitet\n- Overifierade minnen markerade med `[unverified]`\n- Taggar inkluderade för kontext\n- Oformaterad text (ingen JSON-tolkning behövs)\n\n## Nästa steg\n\n- [Memory API](/docs/api/memory)\n- [Minnesbästa praxis](/docs/guides/memory-best-practices)\n- [FTS5-sökning](/docs/concepts/fts5-search)\n","content_html":"

Minnesmodellen

\n

Synapses minnesmodell är utformad för LLM-agenter — tillräckligt strukturerad\nför pålitlig återkallning, tillräckligt flexibel för alla domäner.

\n

Minnesanatomi

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

Fält

\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
FältTypObligatoriskBeskrivning
idsträngautoUnikt ID (mem_xxx)
categoryenum✅En av 8 kategorier
keysträng✅Stabil identifierare (används för uppdateringar)
contentsträng✅Minnesinnehållet (valfri text)
tagssträng[]–För sökning och filtrering
priorityenum–low, normal, high, critical (standard: normal)
sourceenumautouser, agent (vem som lagrade det)
verifiedboolautoHar en människa verifierat detta?
confidenceflyttal–0.0 till 1.0 (standard: 1.0 för user, 0.7 för agent)
expires_attidsstämpel–När minnet ska glömmas
mind_idsträngautoVilken mind som äger detta
created_attidsstämpelautoFörst lagrad
updated_attidsstämpelautoSenast ändrad
\n

Kategorier

\n

Åtta kategorier täcker vanliga användningsområden för LLM-agenter:

\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
KategoriSyfteExempel på innehåll
identityVem användaren är"User is Michael Schäfer, software engineer in Berlin"
preferenceAnvändarinställningar"Prefers concise technical responses"
factVerifierbara fakta"Office is in Berlin, timezone Europe/Berlin"
projectProjektstatus"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillAnvändarens färdigheter"Advanced Python, 10+ years"
mistakeTidigare fel"Forgot to bump npm version — CI failed"
contextSessionskontext"Currently reviewing PR #42"
noteDiverse anteckningar"Try Redis for caching next sprint"
\n

Nycklar: stabila identifierare

\n

Fältet key är kritiskt — det är så ni uppdaterar minnen utan att skapa\ndubbletter.

\n
# First store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Nyckelregler:

\n\n

Taggar: för sökning

\n

Taggar möjliggör snabb filtrering och sökning:

\n
# Find all memories with tag "docker"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker

Bästa praxis för taggar:

\n\n

Prioriteringsnivåer

\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
PrioriteringNär den ska användasÅterkallningsbeteende
criticalIdentitet, juridik, oåterkalleligtAlltid högst upp i återkallning
highAktiva projekt, nyckelinställningarFramträdande i återkallning
normalDe flesta minnen (standard)Standardordning för återkallning
lowEfemärt, trevligt att vetaKan sammanfattas
\n

/memory/recall sorterar efter prioritet (kritisk först), sedan efter aktualitet.

\n

Källa: användare vs agent

\n

Minnen taggas med source:

\n\n

Detta påverkar:

\n\n
Behandla `agent`-källade minnen med lämplig skepsis. De kan vara härledda\neller antagna snarare än direkt angivna av användaren.

Verifiering

\n

Flaggan verified indikerar att en människa har bekräftat minnet:

\n\n

Verifiera minnen via:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
Verifiering kräver JWT (mänsklig autentisering), inte Mind Key\n(agent-autentisering). Detta säkerställer att endast människor kan markera\nminnen som verifierade.

Konfidens

\n

Fältet confidence (0.0 till 1.0) indikerar hur pålitligt minnet är:

\n\n

Sätt konfidens vid lagring:

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

Utgång

\n

Sätt expires_at för tidskänsliga minnen:

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

Utgångna minnen returneras inte av /memory/recall (men finns fortfarande i DB).\nAnvänd /memory/expiring?within=7d för att se minnen som löper ut snart.

\n

Minneslivscykel

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

Återkallningsbeteende

\n

GET /memory/recall returnerar en oformaterad textsammanfattning optimerad\nför LLM-kontext:

\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ästa steg

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