{"title":"メモリモデル","slug":"memory-model","category":"concepts","summary":"メモリの構造 — カテゴリ、キー、タグ、優先度、ソース、検証。","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":420,"read_minutes":2,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# メモリモデル\n\nSynapse のメモリモデルは LLM エージェント向けに設計されています — 信頼できる再取得のための十分な構造と、任意のドメインに対応する柔軟性を備えています。\n\n## メモリの構造\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## フィールド\n\n| フィールド | 型 | 必須 | 説明 |\n|-------|------|----------|-------------|\n| `id` | string | 自動 | ユニーク ID（mem_xxx） |\n| `category` | enum | ✅ | 8 カテゴリのいずれか |\n| `key` | string | ✅ | 安定した識別子（更新に使用） |\n| `content` | string | ✅ | メモリの内容（任意のテキスト） |\n| `tags` | string[] | – | 検索とフィルタリング用 |\n| `priority` | enum | – | low、normal、high、critical（デフォルト：normal） |\n| `source` | enum | 自動 | user、agent（保存者） |\n| `verified` | bool | 自動 | 人間が検証済みか |\n| `confidence` | float | – | 0.0 〜 1.0（デフォルト：user は 1.0、agent は 0.7） |\n| `expires_at` | timestamp | – | このメモリを忘れるタイミング |\n| `mind_id` | string | 自動 | 所有する mind |\n| `created_at` | timestamp | 自動 | 初回保存日時 |\n| `updated_at` | timestamp | 自動 | 最終更新日時 |\n\n## カテゴリ\n\n8 つのカテゴリが一般的な LLM エージェントのユースケースをカバーします。\n\n| カテゴリ | 目的 | 内容の例 |\n|----------|---------|-----------------|\n| `identity` | ユーザーが誰か | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | ユーザーの設定 | \"Prefers concise technical responses\" |\n| `fact` | 検証可能な事実 | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | プロジェクトのステータス | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | ユーザーのスキル | \"Advanced Python, 10+ years\" |\n| `mistake` | 過去のエラー | \"Forgot to bump npm version — CI failed\" |\n| `context` | セッションのコンテキスト | \"Currently reviewing PR #42\" |\n| `note` | その他のメモ | \"Try Redis for caching next sprint\" |\n\n## キー：安定した識別子\n\n`key` フィールドは重要です — 重複を作らずにメモリを更新するための方法です。\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**キーのルール：**\n\n- (category, mind) 内でユニークである必要があります\n- `snake_case` を使用\n- 明確さのためにカテゴリをプレフィックスに：`preference_communication`、`mistake_npm_version`\n- 安定性を保つ — 作成後にキーを変更しない\n\n## タグ：検索用\n\nタグにより高速なフィルタリングと検索が可能です。\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**タグのベストプラクティス：**\n\n- メモリごとに 2〜5 個のタグ（付けすぎない）\n- 一貫性のために小文字\n- プロジェクト名、トピック、技術を使用\n- タグは大文字小文字を区別しません\n\n## 優先度レベル\n\n| 優先度 | 使用場面 | 再取得時の挙動 |\n|----------|-------------|-----------------|\n| `critical` | ID、法的、不可逆 | 常に再取得の先頭 |\n| `high` | 進行中のプロジェクト、主要な設定 | 再取得で目立つ |\n| `normal` | ほとんどのメモリ（デフォルト） | 標準的な再取得順 |\n| `low` | 一時的、知っておくとよいこと | 要約される可能性 |\n\n`/memory/recall` は優先度（critical が先頭）、次に新しさでソートします。\n\n## ソース：user と agent\n\nメモリには `source` が付与されます。\n\n- `user` — 人間が保存（JWT または human UI 経由）\n- `agent` — LLM エージェントが保存（Mind Key 経由）\n\nこれは以下に影響します。\n\n- **検証：** `user` メモリは自動検証、`agent` メモリは未検証\n- **信頼度：** `user` はデフォルト 1.0、`agent` は 0.7\n- **再取得：** `/memory/recall` は未検証メモリに「(unverified)」を付ける\n\n> [!NOTE]\n> `agent` ソースのメモリは適切な懐疑心を持って扱ってください。ユーザーが直接述べたものではなく、推論や仮定の可能性があります。\n\n## 検証\n\n`verified` フラグは人間がメモリを確認したことを示します。\n\n- `user` メモリ：自動検証（`true`）\n- `agent` メモリ：デフォルトで未検証（`false`）\n\n以下でメモリを検証します。\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> 検証には Mind Key（エージェント認証）ではなく JWT（人間の認証）が必要です。これにより、人間のみがメモリを検証済みとしてマークできます。\n\n## 信頼度\n\n`confidence` フィールド（0.0 〜 1.0）はメモリの信頼性を示します。\n\n- 1.0 — ユーザーが直接述べた\n- 0.7 — エージェントが推論した\n- 0.5 — 不確実、検証が必要\n- 0.0 — 明示的に疑わしい\n\n保存時に信頼度を設定します。\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## 有効期限\n\n時間依存のメモリには `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\n期限切れのメモリは `/memory/recall` で返されません（ただし DB には存在）。`/memory/expiring?within=7d` で期限切れが近いメモリを確認できます。\n\n## メモリのライフサイクル\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## 再取得時の挙動\n\n`GET /memory/recall` は 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- 優先度（critical → low）、次に新しさでソート\n- 未検証メモリは `[unverified]` でマーク\n- タグはコンテキストのために含まれる\n- プレーンテキスト（JSON 解析不要）\n\n## 次のステップ\n\n- [Memory API](/docs/api/memory)\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n- [FTS5 Search](/docs/concepts/fts5-search)\n","content_html":"

メモリモデル

\n

Synapse のメモリモデルは LLM エージェント向けに設計されています — 信頼できる再取得のための十分な構造と、任意のドメインに対応する柔軟性を備えています。

\n

メモリの構造

\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\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
フィールド型必須説明
idstring自動ユニーク ID（mem_xxx）
categoryenum✅8 カテゴリのいずれか
keystring✅安定した識別子（更新に使用）
contentstring✅メモリの内容（任意のテキスト）
tagsstring[]–検索とフィルタリング用
priorityenum–low、normal、high、critical（デフォルト：normal）
sourceenum自動user、agent（保存者）
verifiedbool自動人間が検証済みか
confidencefloat–0.0 〜 1.0（デフォルト：user は 1.0、agent は 0.7）
expires_attimestamp–このメモリを忘れるタイミング
mind_idstring自動所有する mind
created_attimestamp自動初回保存日時
updated_attimestamp自動最終更新日時
\n

カテゴリ

\n

8 つのカテゴリが一般的な 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
カテゴリ目的内容の例
identityユーザーが誰か"User is Michael Schäfer, software engineer in Berlin"
preferenceユーザーの設定"Prefers concise technical responses"
fact検証可能な事実"Office is in Berlin, timezone Europe/Berlin"
projectプロジェクトのステータス"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillユーザーのスキル"Advanced Python, 10+ years"
mistake過去のエラー"Forgot to bump npm version — CI failed"
contextセッションのコンテキスト"Currently reviewing PR #42"
noteその他のメモ"Try Redis for caching next sprint"
\n

キー：安定した識別子

\n

key フィールドは重要です — 重複を作らずにメモリを更新するための方法です。

\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

タグにより高速なフィルタリングと検索が可能です。

\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\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
優先度使用場面再取得時の挙動
criticalID、法的、不可逆常に再取得の先頭
high進行中のプロジェクト、主要な設定再取得で目立つ
normalほとんどのメモリ（デフォルト）標準的な再取得順
low一時的、知っておくとよいこと要約される可能性
\n

/memory/recall は優先度（critical が先頭）、次に新しさでソートします。

\n

ソース：user と agent

\n

メモリには source が付与されます。

\n\n

これは以下に影響します。

\n\n
`agent` ソースのメモリは適切な懐疑心を持って扱ってください。ユーザーが直接述べたものではなく、推論や仮定の可能性があります。

検証

\n

verified フラグは人間がメモリを確認したことを示します。

\n\n

以下でメモリを検証します。

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
検証には Mind Key（エージェント認証）ではなく JWT（人間の認証）が必要です。これにより、人間のみがメモリを検証済みとしてマークできます。

信頼度

\n

confidence フィールド（0.0 〜 1.0）はメモリの信頼性を示します。

\n\n

保存時に信頼度を設定します。

\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

時間依存のメモリには 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}

期限切れのメモリは /memory/recall で返されません（ただし DB には存在）。/memory/expiring?within=7d で期限切れが近いメモリを確認できます。

\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

GET /memory/recall は 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

次のステップ

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