{"title":"Chiến lược gắn tag bộ nhớ","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Cách gắn tag bộ nhớ cho tìm kiếm và lọc hiệu quả — hệ thống tag có khả năng mở rộng.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":480,"read_minutes":2,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Chiến lược gắn tag bộ nhớ\n\nTag là bí mật cho thu hồi bộ nhớ có khả năng mở rộng. Hướng dẫn này cho thấy\ncách gắn tag bộ nhớ để đúng cái quay lại đúng thời điểm.\n\n## Tại sao Tag quan trọng\n\nKhông có tag, bạn có tìm kiếm toàn văn phẳng. Với tag, bạn có điều hướng có\ncấu trúc:\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\nTag cho phép:\n\n- **Lọc nhanh** — `GET /memory/by-tag?tag=production`\n- **Tìm kiếm phạm vi** — `?q=auth&tag=project-x`\n- **Nhóm** — tìm tất cả bộ nhớ \"mistake\" cho một dự án\n- **Tham chiếu chéo** — bộ nhớ chia sẻ tag liên quan\n\n## Lược đồ tag\n\n### Tag dự án\n\nSử dụng tên dự án làm tag:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Tag công nghệ\n\nSử dụng tên công nghệ:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Tag chủ đề\n\nSử dụng danh mục chủ đề:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Tag trạng thái\n\nSử dụng chỉ báo trạng thái:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Tag loại\n\nSử dụng chỉ báo loại:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Quy tắc tag\n\n### Quy tắc 1: 2-5 tag mỗi bộ nhớ\n\nQuá ít tag = khả năng khám phá kém. Quá nhiều = nhiễu.\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### Quy tắc 2: Chữ thường, gạch nối\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Quy tắc 3: Sử dụng từ vựng nhất quán\n\nThiết lập từ vựng tag và bám sát nó:\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### Quy tắc 4: Gắn tag với ý định tìm kiếm\n\nHỏi: \"Làm thế nào tôi sẽ tìm kiếm bộ nhớ này?\"\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## Mẫu\n\n### Mẫu 1: Dự án + Chủ đề\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nTìm: `?tag=synapse` (tất cả bộ nhớ dự án Synapse)\nTìm: `?tag=synapse&q=deployment` (bộ nhớ deployment trong Synapse)\n\n### Mẫu 2: Loại + Lĩnh vực\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nTìm: `?tag=mistake` (tất cả lỗi)\nTìm: `?tag=mistake&q=deployment` (lỗi deployment)\n\n### Mẫu 3: Phân cấp\n\nCho dự án con trong một dự án:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nTìm: `?tag=synapse` (tất cả Synapse)\nTìm: `?tag=synapse-docs` (chỉ dự án con docs)\n\n### Mẫu 4: Theo dõi trạng thái\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## Trường hợp sử dụng phổ biến\n\n### Tìm tất cả quyết định về một dự án\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Tìm tất cả lỗi trong một lĩnh vực\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Tìm công việc đang hoạt động\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Tìm bộ nhớ về một công nghệ\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Bảo trì tag\n\n### Xem xét định kỳ\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### Hợp nhất tag\n\nNếu bạn có tag không nhất quán (`docker` và `Docker`), hợp nhất chúng:\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## Thực hành tốt nhất\n\n> [!TIP]\n> - **Thiết lập từ vựng sớm** — tag nhất quán từ ngày 1\n> - **Gắn tag với ý định tìm kiếm** — làm thế nào bạn sẽ tìm cái này sau?\n> - **2-5 tag là điểm ngọt** — quá ít hoặc quá nhiều là xấu\n> - **Chữ thường + gạch nối** — `ci-cd` không phải `CI/CD`\n> - **Xem xét định kỳ** — hợp nhất trùng lặp, xóa không sử dụng\n\n## Bước tiếp theo\n\n- [Thực hành tốt nhất về bộ nhớ](/docs/guides/memory-best-practices)\n- [Tìm kiếm FTS5](/docs/concepts/fts5-search)\n- [Quy trình điều khiển bởi tác vụ](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Chiến lược gắn tag bộ nhớ

\n

Tag là bí mật cho thu hồi bộ nhớ có khả năng mở rộng. Hướng dẫn này cho thấy\ncách gắn tag bộ nhớ để đúng cái quay lại đúng thời điểm.

\n

Tại sao Tag quan trọng

\n

Không có tag, bạn có tìm kiếm toàn văn phẳng. Với tag, bạn có điều hướng có\ncấu trúc:

\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

Tag cho phép:

\n\n

Lược đồ tag

\n

Tag dự án

\n

Sử dụng tên dự án làm tag:

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

Tag công nghệ

\n

Sử dụng tên công nghệ:

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

Tag chủ đề

\n

Sử dụng danh mục chủ đề:

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

Tag trạng thái

\n

Sử dụng chỉ báo trạng thái:

\n
active, completed, blocked, deprecated

Tag loại

\n

Sử dụng chỉ báo loại:

\n
decision, mistake, pattern, reference, todo

Quy tắc tag

\n

Quy tắc 1: 2-5 tag mỗi bộ nhớ

\n

Quá ít tag = khả năng khám phá kém. Quá nhiều = nhiễu.

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

Quy tắc 2: Chữ thường, gạch nối

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

Quy tắc 3: Sử dụng từ vựng nhất quán

\n

Thiết lập từ vựng tag và bám sát nó:

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

Quy tắc 4: Gắn tag với ý định tìm kiếm

\n

Hỏi: "Làm thế nào tôi sẽ tìm kiếm bộ nhớ này?"

\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

Mẫu

\n

Mẫu 1: Dự án + Chủ đề

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

Tìm: ?tag=synapse (tất cả bộ nhớ dự án Synapse)\nTìm: ?tag=synapse&q=deployment (bộ nhớ deployment trong Synapse)

\n

Mẫu 2: Loại + Lĩnh vực

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

Tìm: ?tag=mistake (tất cả lỗi)\nTìm: ?tag=mistake&q=deployment (lỗi deployment)

\n

Mẫu 3: Phân cấp

\n

Cho dự án con trong một dự án:

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

Tìm: ?tag=synapse (tất cả Synapse)\nTìm: ?tag=synapse-docs (chỉ dự án con docs)

\n

Mẫu 4: Theo dõi trạng thái

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

Trường hợp sử dụng phổ biến

\n

Tìm tất cả quyết định về một dự án

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

Tìm tất cả lỗi trong một lĩnh vực

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

Tìm công việc đang hoạt động

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

Tìm bộ nhớ về một công nghệ

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

Bảo trì tag

\n

Xem xét định kỳ

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

Hợp nhất tag

\n

Nếu bạn có tag không nhất quán (docker và Docker), hợp nhất chúng:

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

Thực hành tốt nhất

\n

Bước tiếp theo

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