То, как вы структурируете воспоминания, определяет их полезность. Это руководство\nописывает паттерны категоризации, тегирования и приоритизации, чтобы LLM мог\nотзывать нужную информацию в нужное время.
\n| Категория | \nИспользовать для | \nПример | \n
|---|---|---|
identity | \nИмя пользователя, роль, контакты | \n"user_name": "Michael Schäfer" | \n
preference | \nСимпатии, антипатии, стиль работы | \n"communication": "Prefers concise responses" | \n
fact | \nПроверяемые факты | \n"office_location": "Berlin, Germany" | \n
project | \nСтатус проекта, решения | \n"project_synapse": "v1.5.0 deployed" | \n
skill | \nНавыки пользователя | \n"skill_python": "Advanced, 10+ years" | \n
mistake | \nПрошлые ошибки для избегания | \n"mistake_npm_version": "Always bump version" | \n
context | \nКонтекст сессии | \n"current_focus": "Working on docs system" | \n
note | \nПрочие заметки | \n"note_idea": "Try Redis for caching" | \n
Поле key — идентификатор воспоминания. Используйте значимые, стабильные ключи:
Хорошие ключи:
\nuser_nameproject_synapse_statuspreference_communication_stylemistake_npm_version_bumpПлохие ключи:
\nmem_001 (не значимый)temp (не описательный)2026-06-27-note (дата не помогает отзыву)snake_case (нижний регистр с подчёркиваниями)preference_*, project_*, mistake_*Теги обеспечивают быструю фильтрацию и поиск. Добавляйте 2–5 тегов на воспоминание:
\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| Приоритет | \nИспользовать для | \n% воспоминаний | \n
|---|---|---|
critical | \nИдентичность пользователя, юридическая информация, необратимые решения | \n~5% | \n
high | \nАктивные проекты, важные предпочтения | \n~20% | \n
normal | \nБольшинство фактов, заметок, контекста | \n~65% | \n
low | \nЭфемерное, желательно знать | \n~10% | \n
context с низким приоритетом)POST /memory с теми же category + key обновляет существующее воспоминание:
# 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, хранить для истории# 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")Для иерархического контекста (проект → подпроект → задача):
\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")LLM затем может искать q=synapse+docs, чтобы найти все связанные воспоминания.
Сохраняйте решения с обоснованием, чтобы LLM не переоспаривал их:
\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")Сохраняйте ошибки с конкретными инструкциями по избеганию:
\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")