{"title":"メモリタグ付け戦略","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"効果的な検索とフィルタリングのためのメモリのタグ付け方法 — スケールするタグ付けシステム。","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":162,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# メモリタグ付け戦略\n\nタグはスケーラブルなメモリ取得の秘訣です。本ガイドは、適切なタイミングで適切なメモリが戻ってくるようにメモリにタグを付ける方法を示します。\n\n## タグが重要な理由\n\nタグがない場合、フラットな全文検索しかありません。タグがあれば、構造化されたナビゲーションが可能になります。\n\n```bash\n# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nタグによって可能になること：\n\n- **高速なフィルタリング** — `GET /memory/by-tag?tag=production`\n- **スコープ付き検索** — `?q=auth&tag=project-x`\n- **グループ化** — あるプロジェクトのすべての「失敗」メモリを見つける\n- **相互参照** — タグを共有するメモリは関連している\n\n## タグ付けスキーマ\n\n### プロジェクトタグ\n\nプロジェクト名をタグとして使用します：\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### テクノロジータグ\n\nテクノロジー名を使用します：\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### トピックタグ\n\nトピックカテゴリを使用します：\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### ステータスタグ\n\nステータス指標を使用します：\n\n```\nactive, completed, blocked, deprecated\n```\n\n### タイプタグ\n\nタイプ指標を使用します：\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## タグ付けルール\n\n### ルール 1：メモリあたり 2〜5 個のタグ\n\n少なすぎると発見性が低くなり、多すぎるとノイズになります。\n\n```json\n// Good: 3 relevant tags\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// Bad: 1 tag (too narrow)\n{ \"tags\": [\"synapse\"] }\n\n// Bad: 10 tags (noise)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### ルール 2：小文字、ハイフン区切り\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### ルール 3：一貫した語彙を使用\n\nタグ付けの語彙を確立し、それに従ってください：\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### ルール 4：検索意図でタグ付け\n\n「このメモリをどうやって検索するか？」を自問してください。\n\n```json\n// Storing a deployment decision\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment\n```\n\n## パターン\n\n### パターン 1：プロジェクト + トピック\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\n検索：`?tag=synapse`（Synapse プロジェクトのすべてのメモリ）\n検索：`?tag=synapse&q=deployment`（Synapse 内のデプロイ関連メモリ）\n\n### パターン 2：タイプ + ドメイン\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\n検索：`?tag=mistake`（すべての失敗）\n検索：`?tag=mistake&q=deployment`（デプロイ関連の失敗）\n\n### パターン 3：階層型\n\nプロジェクト内のサブプロジェクト用：\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\n検索：`?tag=synapse`（Synapse 全体）\n検索：`?tag=synapse-docs`（docs サブプロジェクトのみ）\n\n### パターン 4：ステータス追跡\n\n```json\n// Active project\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// Completed project\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// Blocked\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## よくあるユースケース\n\n### プロジェクトに関するすべての決定を見つける\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### ドメイン内のすべての失敗を見つける\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### アクティブな作業を見つける\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### 技術に関するメモリを見つける\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## タグのメンテナンス\n\n### 定期的なレビュー\n\n```python\n# Find rarely-used tags (candidates for cleanup)\ntags = requests.get(f\"{URL}/memory/tags\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\nfor tag, count in tags.items():\n if count < 2:\n print(f\"Rare tag: {tag} ({count} memories)\")\n```\n\n### タグの統合\n\nタグに一貫性がない場合（`docker` と `Docker`）は統合してください：\n\n```python\n# Find all memories with \"Docker\" tag\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# Update each to use \"docker\" instead\nfor mem in mems[\"results\"]:\n tags = [t.lower() for t in mem[\"tags\"]]\n update_memory(mem[\"id\"], tags=list(set(tags)))\n```\n\n## ベストプラクティス\n\n> [!TIP]\n> - **早期に語彙を確立** — 1 日目から一貫したタグを\n> - **検索意図でタグ付け** — 後でどうやって見つけるか？\n> - **2〜5 個が最適** — 少なすぎても多すぎても悪い\n> - **小文字 + ハイフン** — `CI/CD` ではなく `ci-cd`\n> - **定期的にレビュー** — 重複を統合、未使用を削除\n\n## 次のステップ\n\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n- [FTS5 Search](/docs/concepts/fts5-search)\n- [Task-Driven Workflow](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

メモリタグ付け戦略

\n

タグはスケーラブルなメモリ取得の秘訣です。本ガイドは、適切なタイミングで適切なメモリが戻ってくるようにメモリにタグを付ける方法を示します。

\n

タグが重要な理由

\n

タグがない場合、フラットな全文検索しかありません。タグがあれば、構造化されたナビゲーションが可能になります。

\n
# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker

タグによって可能になること：

\n\n

タグ付けスキーマ

\n

プロジェクトタグ

\n

プロジェクト名をタグとして使用します：

\n
synapse, synapse-mcp, synapse-chat, synapse-sdk

テクノロジータグ

\n

テクノロジー名を使用します：

\n
docker, kubernetes, postgres, fastify, react, typescript

トピックタグ

\n

トピックカテゴリを使用します：

\n
deployment, ci-cd, auth, database, frontend, backend, security

ステータスタグ

\n

ステータス指標を使用します：

\n
active, completed, blocked, deprecated

タイプタグ

\n

タイプ指標を使用します：

\n
decision, mistake, pattern, reference, todo

タグ付けルール

\n

ルール 1：メモリあたり 2〜5 個のタグ

\n

少なすぎると発見性が低くなり、多すぎるとノイズになります。

\n
// Good: 3 relevant tags\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// Bad: 1 tag (too narrow)\n{ "tags": ["synapse"] }\n\n// Bad: 10 tags (noise)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

ルール 2：小文字、ハイフン区切り

\n
✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey

ルール 3：一貫した語彙を使用

\n

タグ付けの語彙を確立し、それに従ってください：

\n
# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE

ルール 4：検索意図でタグ付け

\n

「このメモリをどうやって検索するか？」を自問してください。

\n
// Storing a deployment decision\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment

パターン

\n

パターン 1：プロジェクト + トピック

\n
{ "tags": ["synapse", "deployment"] }\n{ "tags": ["synapse", "auth"] }\n{ "tags": ["synapse-mcp", "tools"] }

検索：?tag=synapse（Synapse プロジェクトのすべてのメモリ）\n検索：?tag=synapse&q=deployment（Synapse 内のデプロイ関連メモリ）

\n

パターン 2：タイプ + ドメイン

\n
{ "tags": ["mistake", "deployment"] }\n{ "tags": ["decision", "database"] }\n{ "tags": ["pattern", "auth"] }

検索：?tag=mistake（すべての失敗）\n検索：?tag=mistake&q=deployment（デプロイ関連の失敗）

\n

パターン 3：階層型

\n

プロジェクト内のサブプロジェクト用：

\n
{ "tags": ["synapse", "synapse-docs", "markdown"] }\n{ "tags": ["synapse", "synapse-mcp", "mcp"] }\n{ "tags": ["synapse", "synapse-admin", "ui"] }

検索：?tag=synapse（Synapse 全体）\n検索：?tag=synapse-docs（docs サブプロジェクトのみ）

\n

パターン 4：ステータス追跡

\n
// Active project\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// Completed project\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// Blocked\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

よくあるユースケース

\n

プロジェクトに関するすべての決定を見つける

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=decision&tag=synapse"

ドメイン内のすべての失敗を見つける

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=mistake&tag=deployment"

アクティブな作業を見つける

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/by-tag?tag=active"

技術に関するメモリを見つける

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=postgres+performance&tag=database"

タグのメンテナンス

\n

定期的なレビュー

\n
# Find rarely-used tags (candidates for cleanup)\ntags = requests.get(f"{URL}/memory/tags",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\nfor tag, count in tags.items():\n    if count < 2:\n        print(f"Rare tag: {tag} ({count} memories)")

タグの統合

\n

タグに一貫性がない場合（docker と Docker）は統合してください：

\n
# Find all memories with "Docker" tag\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# Update each to use "docker" instead\nfor mem in mems["results"]:\n    tags = [t.lower() for t in mem["tags"]]\n    update_memory(mem["id"], tags=list(set(tags)))

ベストプラクティス

\n

次のステップ

\n\n","urls":{"html":"/docs/llm-cookbook/memory-tagging-strategy","text":"/docs/llm-cookbook/memory-tagging-strategy?format=text","json":"/docs/llm-cookbook/memory-tagging-strategy?format=json","llm":"/docs/llm-cookbook/memory-tagging-strategy?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}