Hoe u herinneringen structureert bepaalt hoe nuttig ze zijn. Deze handleiding behandelt\npatronen voor het categoriseren, taggen en prioriteren van herinneringen zodat de LLM\nde juiste informatie op het juiste moment kan ophalen.
\n| Categorie | \nGebruik voor | \nVoorbeeld | \n
|---|---|---|
identity | \nGebruikersnaam, rol, contactgegevens | \n"user_name": "Michael Schäfer" | \n
preference | \nVoorkeuren, afkeuren, werkstijl | \n"communication": "Prefers concise responses" | \n
fact | \nVerifieerbare feiten | \n"office_location": "Berlin, Germany" | \n
project | \nProjectstatus, beslissingen | \n"project_synapse": "v1.5.0 deployed" | \n
skill | \nVaardigheden van de gebruiker | \n"skill_python": "Advanced, 10+ years" | \n
mistake | \nEerdere fouten om te vermijden | \n"mistake_npm_version": "Always bump version" | \n
context | \nSessie-relevante context | \n"current_focus": "Working on docs system" | \n
note | \nDiverse notities | \n"note_idea": "Try Redis for caching" | \n
Het key-veld is de identificator van de herinnering. Gebruik betekenisvolle, stabiele sleutels:
Goede sleutels:
\nuser_nameproject_synapse_statuspreference_communication_stylemistake_npm_version_bumpSlechte sleutels:
\nmem_001 (niet betekenisvol)temp (niet beschrijvend)2026-06-27-note (datum helpt niet bij recall)snake_case (kleine letters met underscores)preference_*, project_*, mistake_*Tags maken snelle filtering en zoekopdrachten mogelijk. Voeg 2-5 tags toe per herinnering:
\n{\n "category": "project",\n "key": "project_synapse_status",\n "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.",\n "tags": ["synapse", "deployment", "status", "v1.5.0"]\n}synapse, synapse-mcp, synapse-chatdeployment, ci, database, authactive, completed, blockedurgent, long-term| Prioriteit | \nGebruik voor | \n% van herinneringen | \n
|---|---|---|
critical | \nGebruikersidentiteit, juridische info, onomkeerbare beslissingen | \n~5% | \n
high | \nActieve projecten, belangrijke voorkeuren | \n~20% | \n
normal | \nMeeste feiten, notities, context | \n~65% | \n
low | \nEfemeer, leuk-om-te-weten | \n~10% | \n
Gebruikersidentiteit (naam, e-mail, rol)
\nLangetermijnvoorkeuren
\nProjectbeslissingen en rationaal
\nEerdere fouten en geleerde lessen
\nGemaakte toezeggingen aan de gebruiker
\nNiet opslaan
\nTijdelijke staat (gebruik variabelen)
\nLetterlijke gespreksgeschiedenis (chat-systeem handelt dit af)
\nGevoelige data (wachtwoorden, API-sleutels)
\nGemakkelijk af te leiden feiten (huidige datum, bestandsinhouden)
\nEfemere context (gebruik context-categorie met lage prioriteit)
POST /memory met dezelfde category + key werkt de bestaande herinnering bij:
# Initial store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Later: update with same key\nstore("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")Create → Active → Stale → Archive → Deletelow, bewaar voor historische referentie# Find memories not updated in 90 days\nold_memories = requests.get(\n f"{URL}/memory/search?q=*",\n headers={"Authorization": f"Bearer {KEY}"}\n)\n\nfor mem in old_memories["results"]:\n if is_stale(mem, days=90):\n # Either delete or lower priority\n if is_obsolete(mem):\n delete_memory(mem["id"])\n else:\n update_memory(mem["id"], priority="low")Voor hiërarchische context (project → subproject → taak):
\n# Parent project\nstore("project", "project_synapse", "Main Synapse project", \n tags=["synapse", "parent"], priority="high")\n\n# Sub-project (tags link to parent)\nstore("project", "project_synapse_docs", "Docs system for Synapse",\n tags=["synapse", "docs", "synapse-parent"], priority="high")\n\n# Specific task (tags link to sub-project)\nstore("project", "task_docs_loader", "Implement docs-loader.ts",\n tags=["synapse", "docs", "task"], priority="normal")De LLM kan dan q=synapse+docs zoeken om alle gerelateerde herinneringen te vinden.
Sla beslissingen met rationaal op zodat de LLM ze niet heroverweegt:
\nstore("fact", "decision_postgres_over_sqlite",\n "Chose PostgreSQL over SQLite for production. Reason: concurrent writes, "\n "FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.",\n tags=["decision", "database", "postgres", "sqlite"],\n priority="high")Sla fouten op met specifieke vermijdingsinstructies:
\nstore("mistake", "mistake_forget_version_bump",\n "Forgot to bump package.json version after changes. npm publish failed. "\n "FIX: Always run `npm version patch` before pushing. "\n "CI fails with 'version already exists' if you forget.",\n tags=["npm", "ci", "publish", "version"],\n priority="high")