{"title":"กลยุทธ์การ Tag Memory","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"วิธี tag memory เพื่อการค้นหาและกรองที่มีประสิทธิภาพ — ระบบ tagging ที่ scale ได้","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":251,"read_minutes":1,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# กลยุทธ์การ Tag Memory\n\ntag เป็นความลับของการดึง memory ที่ scale ได้ คู่มือนี้แสดงวิธี tag memory เพื่อให้ตัวที่ถูกต้องกลับมาในเวลาที่เหมาะสม\n\n## ทำไม tag ถึงสำคัญ\n\nไม่มี tag คุณมีแค่ full-text search แบบ flat มี tag คุณมีการนำทางที่มีโครงสร้าง:\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 เปิดใช้งาน:\n\n- **การกรองที่รวดเร็ว** — `GET /memory/by-tag?tag=production`\n- **Scoped search** — `?q=auth&tag=project-x`\n- **การจัดกลุ่ม** — หา memory \"mistake\" ทั้งหมดของโปรเจกต์\n- **การอ้างอิงข้าม** — memory ที่แชร์ tag เกี่ยวข้องกัน\n\n## Schema Tagging\n\n### Project tag\n\nใช้ชื่อโปรเจกต์เป็น tag:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Technology tag\n\nใช้ชื่อเทคโนโลยี:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Topic tag\n\nใช้หมวดหมู่หัวข้อ:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Status tag\n\nใช้ตัวบ่งชี้สถานะ:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Type tag\n\nใช้ตัวบ่งชี้ประเภท:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## กฎการ Tag\n\n### กฎ 1: 2-5 tag ต่อ memory\n\ntag น้อยเกินไป = ความสามารถในการค้นพบต่ำ tag มากเกินไป = noise\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: ตัวพิมพ์เล็ก, ใช้ hyphen\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### กฎ 3: ใช้คำศัพท์ที่สม่ำเสมอ\n\nกำหนดคำศัพท์ tagging และยึดติดกับมัน:\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### กฎ 4: Tag ด้วยเจตนาการค้นหา\n\nถาม: \"ฉันจะค้นหา memory นี้อย่างไร?\"\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: Project + Topic\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nSearch: `?tag=synapse` (memory โปรเจกต์ Synapse ทั้งหมด)\nSearch: `?tag=synapse&q=deployment` (memory deployment ใน Synapse)\n\n### รูปแบบ 2: Type + Domain\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nSearch: `?tag=mistake` (mistake ทั้งหมด)\nSearch: `?tag=mistake&q=deployment` (mistake 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\nSearch: `?tag=synapse` (Synapse ทั้งหมด)\nSearch: `?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### หา mistake ทั้งหมดใน domain\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### หางานที่ active\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### หา memory เกี่ยวกับเทคโนโลยี\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## การบำรุงรักษา tag\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### การรวม tag\n\nหากคุณมี tag ไม่สม่ำเสมอ (`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> - **กำหนดคำศัพท์ตั้งแต่เริ่ม** — tag สม่ำเสมอตั้งแต่วันแรก\n> - **Tag ด้วยเจตนาการค้นหา** — คุณจะหาสิ่งนี้อย่างไรในภายหลัง?\n> - **2-5 tag เป็นจุดที่เหมาะ** — น้อยหรือมากเกินไปไม่ดี\n> - **ตัวพิมพ์เล็ก + hyphen** — `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":"

กลยุทธ์การ Tag Memory

\n

tag เป็นความลับของการดึง memory ที่ scale ได้ คู่มือนี้แสดงวิธี tag memory เพื่อให้ตัวที่ถูกต้องกลับมาในเวลาที่เหมาะสม

\n

ทำไม tag ถึงสำคัญ

\n

ไม่มี tag คุณมีแค่ full-text search แบบ flat มี tag คุณมีการนำทางที่มีโครงสร้าง:

\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 เปิดใช้งาน:

\n\n

Schema Tagging

\n

Project tag

\n

ใช้ชื่อโปรเจกต์เป็น tag:

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

Technology tag

\n

ใช้ชื่อเทคโนโลยี:

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

Topic tag

\n

ใช้หมวดหมู่หัวข้อ:

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

Status tag

\n

ใช้ตัวบ่งชี้สถานะ:

\n
active, completed, blocked, deprecated

Type tag

\n

ใช้ตัวบ่งชี้ประเภท:

\n
decision, mistake, pattern, reference, todo

กฎการ Tag

\n

กฎ 1: 2-5 tag ต่อ memory

\n

tag น้อยเกินไป = ความสามารถในการค้นพบต่ำ tag มากเกินไป = noise

\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: ตัวพิมพ์เล็ก, ใช้ hyphen

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

กฎ 3: ใช้คำศัพท์ที่สม่ำเสมอ

\n

กำหนดคำศัพท์ tagging และยึดติดกับมัน:

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

กฎ 4: Tag ด้วยเจตนาการค้นหา

\n

ถาม: "ฉันจะค้นหา memory นี้อย่างไร?"

\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: Project + Topic

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

Search: ?tag=synapse (memory โปรเจกต์ Synapse ทั้งหมด)\nSearch: ?tag=synapse&q=deployment (memory deployment ใน Synapse)

\n

รูปแบบ 2: Type + Domain

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

Search: ?tag=mistake (mistake ทั้งหมด)\nSearch: ?tag=mistake&q=deployment (mistake deployment)

\n

รูปแบบ 3: ลำดับชั้น

\n

สำหรับโปรเจกต์ย่อยในโปรเจกต์:

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

Search: ?tag=synapse (Synapse ทั้งหมด)\nSearch: ?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"

หา mistake ทั้งหมดใน domain

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

หางานที่ active

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

หา memory เกี่ยวกับเทคโนโลยี

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

การบำรุงรักษา tag

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

การรวม tag

\n

หากคุณมี tag ไม่สม่ำเสมอ (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"]}