{"title":"Het Memory-model","slug":"memory-model","category":"concepts","summary":"Hoe herinneringen zijn gestructureerd — categorieën, sleutels, tags, prioriteiten, bronnen, verificatie.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":687,"read_minutes":3,"lang":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# Het Memory-model\n\nHet memory-model van Synapse is ontworpen voor LLM-agents — gestructureerd genoeg voor\nbetrouwbare recall, flexibel genoeg voor elk domein.\n\n## Anatomie van een herinnering\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## Velden\n\n| Veld | Type | Vereist | Beschrijving |\n|------|------|---------|--------------|\n| `id` | string | auto | Unieke ID (mem_xxx) |\n| `category` | enum | ✅ | Een van 8 categorieën |\n| `key` | string | ✅ | Stabiele identificator (gebruikt voor updates) |\n| `content` | string | ✅ | De memory-inhoud (willekeurige tekst) |\n| `tags` | string[] | – | Voor zoeken en filteren |\n| `priority` | enum | – | low, normal, high, critical (standaard: normal) |\n| `source` | enum | auto | user, agent (wie heeft het opgeslagen) |\n| `verified` | bool | auto | Heeft een mens dit geverifieerd? |\n| `confidence` | float | – | 0.0 tot 1.0 (standaard: 1.0 voor user, 0.7 voor agent) |\n| `expires_at` | timestamp | – | Wanneer deze herinnering vergeten moet worden |\n| `mind_id` | string | auto | Welke mind eigenaar is |\n| `created_at` | timestamp | auto | Eerst opgeslagen |\n| `updated_at` | timestamp | auto | Laatst gewijzigd |\n\n## Categorieën\n\nAcht categorieën dekken de veelvoorkomende LLM-agent-toepassingen:\n\n| Categorie | Doel | Voorbeeldinhoud |\n|-----------|------|-----------------|\n| `identity` | Wie de gebruiker is | \"Gebruiker is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Gebruikersvoorkeuren | \"Geeft de voorkeur aan beknopte technische antwoorden\" |\n| `fact` | Verifieerbare feiten | \"Kantoor is in Berlin, tijdzone Europe/Berlin\" |\n| `project` | Projectstatus | \"Synapse v1.5.0 uitgerold, bezig met v1.6.0 docs\" |\n| `skill` | Vaardigheden van de gebruiker | \"Gevorderd Python, 10+ jaar\" |\n| `mistake` | Eerdere fouten | \"Vergeten npm-versie te verhogen — CI faalde\" |\n| `context` | Sessie-context | \"Momenteel PR #42 aan het beoordelen\" |\n| `note` | Diverse notities | \"Probeer Redis voor caching in volgende sprint\" |\n\n## Sleutels: stabiele identificatoren\n\nHet `key`-veld is kritiek — het is hoe u herinneringen bijwerkt zonder duplicaten\nte maken.\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**Sleutelregels:**\n\n- Moet uniek zijn binnen (category, mind)\n- Gebruik `snake_case`\n- Voorvoeg met categorie voor duidelijkheid: `preference_communication`, `mistake_npm_version`\n- Houd stabiel — wijzig sleutels niet na aanmaak\n\n## Tags: voor zoeken\n\nTags maken snelle filtering en zoekopdrachten mogelijk:\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**Tag-best-practices:**\n\n- 2-5 tags per herinnering (over-tag niet)\n- Kleine letters voor consistentie\n- Gebruik projectnamen, onderwerpen, technologieën\n- Tags zijn niet hoofdlettergevoelig\n\n## Prioriteitsniveaus\n\n| Prioriteit | Wanneer te gebruiken | Recall-gedrag |\n|------------|----------------------|---------------|\n| `critical` | Identiteit, juridisch, onomkeerbaar | Altijd bovenaan recall |\n| `high` | Actieve projecten, kernvoorkeuren | Prominent in recall |\n| `normal` | Meeste herinneringen (standaard) | Standaard recall-volgorde |\n| `low` | Efemeer, leuk-om-te-weten | Kan worden samengevat |\n\n`/memory/recall` sorteert op prioriteit (critical eerst), dan op recentheid.\n\n## Bron: User versus Agent\n\nHerinneringen worden getagd met `source`:\n\n- `user` — opgeslagen door een mens (via JWT of human-UI)\n- `agent` — opgeslagen door een LLM-agent (via Mind Key)\n\nDit beïnvloedt:\n\n- **Verificatie**: `user`-herinneringen worden automatisch geverifieerd, `agent`-herinneringen niet\n- **Betrouwbaarheid**: `user` standaard 1.0, `agent` 0.7\n- **Recall**: `/memory/recall` markeert niet-geverifieerde herinneringen met \"(unverified)\"\n\n> [!NOTE]\n> Behandel `agent`-bron-herinneringen met gepast skepticisme. Ze kunnen zijn\n> afgeleid of aangenomen in plaats van direct door de gebruiker gesteld.\n\n## Verificatie\n\nDe `verified`-vlag geeft aan dat een mens de herinnering heeft bevestigd:\n\n- `user`-herinneringen: automatisch geverifieerd (`true`)\n- `agent`-herinneringen: standaard niet-geverifieerd (`false`)\n\nVerifieer herinneringen 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> Verificatie vereist JWT (mens-auth), niet Mind Key (agent-auth). Dit\n> zorgt ervoor dat alleen mensen herinneringen als geverifieerd kunnen markeren.\n\n## Betrouwbaarheid\n\nHet `confidence`-veld (0.0 tot 1.0) geeft aan hoe betrouwbaar de herinnering is:\n\n- 1.0 — direct door gebruiker gesteld\n- 0.7 — door agent afgeleid\n- 0.5 — onzeker, vereist verificatie\n- 0.0 — expliciet betwijfeld\n\nStel betrouwbaarheid in bij opslaan:\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## Verval\n\nStel `expires_at` in voor tijdgevoelige herinneringen:\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\nVerlopen herinneringen worden niet geretourneerd door `/memory/recall` (maar bestaan nog wel in DB).\nGebruik `/memory/expiring?within=7d` om herinneringen te zien die binnenkort verlopen.\n\n## Memory-levenscyclus\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## Recall-gedrag\n\n`GET /memory/recall` retourneert een platte-tekst samenvatting geoptimaliseerd voor LLM-context:\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- Gesorteerd op prioriteit (critical → low), dan op recentheid\n- Niet-geverifieerde herinneringen gemarkeerd met `[unverified]`\n- Tags inbegrepen voor context\n- Platte tekst (geen JSON-parsing nodig)\n\n## Volgende stappen\n\n- [Memory API](/docs/api/memory)\n- [Memory-best-practices](/docs/guides/memory-best-practices)\n- [FTS5-zoekopdracht](/docs/concepts/fts5-search)\n","content_html":"

Het Memory-model

\n

Het memory-model van Synapse is ontworpen voor LLM-agents — gestructureerd genoeg voor\nbetrouwbare recall, flexibel genoeg voor elk domein.

\n

Anatomie van een herinnering

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

Velden

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VeldTypeVereistBeschrijving
idstringautoUnieke ID (mem_xxx)
categoryenum✅Een van 8 categorieën
keystring✅Stabiele identificator (gebruikt voor updates)
contentstring✅De memory-inhoud (willekeurige tekst)
tagsstring[]–Voor zoeken en filteren
priorityenum–low, normal, high, critical (standaard: normal)
sourceenumautouser, agent (wie heeft het opgeslagen)
verifiedboolautoHeeft een mens dit geverifieerd?
confidencefloat–0.0 tot 1.0 (standaard: 1.0 voor user, 0.7 voor agent)
expires_attimestamp–Wanneer deze herinnering vergeten moet worden
mind_idstringautoWelke mind eigenaar is
created_attimestampautoEerst opgeslagen
updated_attimestampautoLaatst gewijzigd
\n

Categorieën

\n

Acht categorieën dekken de veelvoorkomende LLM-agent-toepassingen:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategorieDoelVoorbeeldinhoud
identityWie de gebruiker is"Gebruiker is Michael Schäfer, software engineer in Berlin"
preferenceGebruikersvoorkeuren"Geeft de voorkeur aan beknopte technische antwoorden"
factVerifieerbare feiten"Kantoor is in Berlin, tijdzone Europe/Berlin"
projectProjectstatus"Synapse v1.5.0 uitgerold, bezig met v1.6.0 docs"
skillVaardigheden van de gebruiker"Gevorderd Python, 10+ jaar"
mistakeEerdere fouten"Vergeten npm-versie te verhogen — CI faalde"
contextSessie-context"Momenteel PR #42 aan het beoordelen"
noteDiverse notities"Probeer Redis voor caching in volgende sprint"
\n

Sleutels: stabiele identificatoren

\n

Het key-veld is kritiek — het is hoe u herinneringen bijwerkt zonder duplicaten\nte maken.

\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")

Sleutelregels:

\n\n

Tags: voor zoeken

\n

Tags maken snelle filtering en zoekopdrachten mogelijk:

\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

Tag-best-practices:

\n\n

Prioriteitsniveaus

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PrioriteitWanneer te gebruikenRecall-gedrag
criticalIdentiteit, juridisch, onomkeerbaarAltijd bovenaan recall
highActieve projecten, kernvoorkeurenProminent in recall
normalMeeste herinneringen (standaard)Standaard recall-volgorde
lowEfemeer, leuk-om-te-wetenKan worden samengevat
\n

/memory/recall sorteert op prioriteit (critical eerst), dan op recentheid.

\n

Bron: User versus Agent

\n

Herinneringen worden getagd met source:

\n\n

Dit beïnvloedt:

\n\n
Behandel `agent`-bron-herinneringen met gepast skepticisme. Ze kunnen zijn\nafgeleid of aangenomen in plaats van direct door de gebruiker gesteld.

Verificatie

\n

De verified-vlag geeft aan dat een mens de herinnering heeft bevestigd:

\n\n

Verifieer herinneringen via:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
Verificatie vereist JWT (mens-auth), niet Mind Key (agent-auth). Dit\nzorgt ervoor dat alleen mensen herinneringen als geverifieerd kunnen markeren.

Betrouwbaarheid

\n

Het confidence-veld (0.0 tot 1.0) geeft aan hoe betrouwbaar de herinnering is:

\n\n

Stel betrouwbaarheid in bij opslaan:

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

Verval

\n

Stel expires_at in voor tijdgevoelige herinneringen:

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

Verlopen herinneringen worden niet geretourneerd door /memory/recall (maar bestaan nog wel in DB).\nGebruik /memory/expiring?within=7d om herinneringen te zien die binnenkort verlopen.

\n

Memory-levenscyclus

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

Recall-gedrag

\n

GET /memory/recall retourneert een platte-tekst samenvatting geoptimaliseerd voor LLM-context:

\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

Volgende stappen

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