{"title":"แนวทางปฏิบัติที่ดีที่สุดสำหรับ Memory","slug":"memory-best-practices","category":"guides","summary":"วิธีจัดโครงสร้าง memory เพื่อ recall ที่มีประสิทธิภาพ — category, key, tag, priority","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":443,"read_minutes":2,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# แนวทางปฏิบัติที่ดีที่สุดสำหรับ Memory\n\nวิธีที่คุณจัดโครงสร้าง memory กำหนดว่ามันจะมีประโยชน์แค่ไหน คู่มือนี้ครอบคลุมรูปแบบสำหรับจัด category, tag และกำหนด priority ของ memory เพื่อให้ LLM recall ข้อมูลที่ถูกต้องในเวลาที่เหมาะสม\n\n## Category: เลือกอันที่เฉพาะเจาะจงที่สุด\n\n| Category | ใช้สำหรับ | ตัวอย่าง |\n|----------|---------|---------|\n| `identity` | ชื่อผู้ใช้, role, ข้อมูลติดต่อ | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | สิ่งที่ชอบ/ไม่ชอบ, สไตล์การทำงาน | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | fact ที่ตรวจสอบได้ | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | สถานะโปรเจกต์, การตัดสินใจ | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | ทักษะผู้ใช้ | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | error ในอดีตที่ต้องหลีกเลี่ยง | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | context ที่เกี่ยวข้องกับ session | `\"current_focus\": \"Working on docs system\"` |\n| `note` | note อื่น ๆ | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> เมื่อไม่แน่ใจ ใช้ `fact` สำหรับข้อมูลที่ตรวจสอบได้ และ `note` สำหรับทุกอย่างอื่น อย่า categorize มากเกินไป — `fact` ที่ชัดเจนดีกว่า `context` ที่สับสน\n\n## Key: identifier ที่มีความหมาย\n\nฟิลด์ `key` เป็น identifier ของ memory ใช้ key ที่มีความหมายและคงที่:\n\n**Key ที่ดี:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Key ที่ไม่ดี:**\n- `mem_001` (ไม่มีความหมาย)\n- `temp` (ไม่บรรยาย)\n- `2026-06-27-note` (วันที่ไม่ช่วย recall)\n\n### หลักการตั้งชื่อ key\n\n- `snake_case` (ตัวพิมพ์เล็กด้วย underscore)\n- นำหน้าด้วย category: `preference_*`, `project_*`, `mistake_*`\n- ใช้คำนามที่บรรยาย ไม่ใช่กริยา\n- ความยาวไม่เกิน 50 ตัวอักษร\n\n## Tag: สำหรับการค้นหาและกรอง\n\nTag เปิดใช้งานการกรองและค้นหาที่รวดเร็ว เพิ่ม 2-5 tag ต่อ memory:\n\n```json\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}\n```\n\n### รูปแบบ tag\n\n- **ชื่อโปรเจกต์**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **หัวข้อ**: `deployment`, `ci`, `database`, `auth`\n- **สถานะ**: `active`, `completed`, `blocked`\n- **ตัวบ่งชี้ priority**: `urgent`, `long-term`\n\n> [!NOTE]\n> tag ไม่ sensitive ต่อตัวพิมพ์เล็ก/ใหญ่ ใช้ตัวพิมพ์เล็กเพื่อความสม่ำเสมอ\n\n## Priority: สมจริง\n\n| Priority | ใช้สำหรับ | % ของ Memory |\n|----------|---------|---------------|\n| `critical` | ตัวตนผู้ใช้, ข้อมูลทางกฎหมาย, การตัดสินใจย้อนกลับไม่ได้ | ~5% |\n| `high` | โปรเจกต์ที่ใช้งาน, ค่ากำหนดสำคัญ | ~20% |\n| `normal` | fact, note, context ส่วนใหญ่ | ~65% |\n| `low` | ชั่วคราว, รู้ไว้ก็ดี | ~10% |\n\n> [!WARNING]\n> อย่าทำเครื่องหมายทุกอย่างเป็น `critical` ถ้าทุกอย่าง critical ก็ไม่มีอะไร critical เลย สงวน `critical` สำหรับสิ่งที่จะก่อให้เกิดอันตรายจริงหากลืม\n\n## เมื่อใดเก็บ vs ไม่เก็บ\n\n### เก็บเสมอ\n\n- ตัวตนผู้ใช้ (ชื่อ, email, role)\n- ค่ากำหนดระยะยาว\n- การตัดสินใจและเหตุผลของโปรเจกต์\n- mistake และบทเรียนในอดีต\n- คำมั่นสัญญาที่ให้กับผู้ใช้\n\n### ไม่เก็บ\n\n- state ชั่วคราว (ใช้ variable แทน)\n- ประวัติการสนทนาแบบ verbatim (ระบบแช็ตจัดการสิ่งนี้)\n- ข้อมูล sensitive (รหัสผ่าน, API key)\n- fact ที่ derive ง่าย (วันที่ปัจจุบัน, เนื้อหาไฟล์)\n- context ชั่วคราว (ใช้ category `context` พร้อม priority ต่ำ)\n\n## การอัปเดต Memory\n\nPOST `/memory` ด้วย `category` + `key` เดิมจะอัปเดต memory ที่มีอยู่:\n\n```python\n# 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\")\n```\n\n> [!TIP]\n> ใช้ key ที่คงที่เพื่อให้อัปเดตได้โดยไม่สร้างซ้ำ LLM ควร POST ซ้ำ key เดิมเมื่อข้อมูลเปลี่ยน ไม่ใช่สร้าง memory ใหม่\n\n## วงจรชีวิต Memory\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory พร้อม context เต็ม\n- **Active**: recall บ่อย, อัปเดตตามต้องการ\n- **Stale**: ยังเกี่ยวข้องแต่ไม่ได้ใช้งาน (priority ต่ำกว่า?)\n- **Archive**: ตั้ง priority เป็น `low`, เก็บเพื่ออ้างอิงทางประวัติศาสตร์\n- **Delete**: DELETE /memory/:id เมื่อไม่เกี่ยวข้องอีก\n\n### การทำความสะอาดเป็นคาบ\n\n```python\n# 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```\n\n## รูปแบบ: การสืบทอด Memory\n\nสำหรับ context แบบลำดับชั้น (โปรเจกต์ → โปรเจกต์ย่อย → task):\n\n```python\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\")\n```\n\nLLM สามารถค้นหา `q=synapse+docs` เพื่อหา memory ที่เกี่ยวข้องทั้งหมด\n\n## รูปแบบ: Decision Log\n\nเก็บการตัดสินใจพร้อมเหตุผลเพื่อให้ LLM ไม่ต้องถกเถียงใหม่:\n\n```python\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\")\n```\n\n## รูปแบบ: การหลีกเลี่ยง Mistake\n\nเก็บ mistake พร้อมคำแนะนำการหลีกเลี่ยงเฉพาะ:\n\n```python\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\")\n```\n\n## รูปแบบที่ควรหลีกเลี่ยง\n\n> [!WARNING]\n> - **เก็บ log การสนทนา** — ระบบแช็ตจัดการสิ่งนี้\n> - **เก็บไฟล์ทั้งหมด** — ใช้ script store หรือ external storage\n> - **เก็บ state ชั่วคราว** — ใช้ variable\n> - **เก็บ secret** — ใช้ environment variable\n> - **ซ้ำ memory** — ใช้ key ที่คงที่\n> - **tag มากเกินไป** — 2-5 tag ต่อ memory เป็นอุดมคติ\n> - **ทุกอย่างเป็น critical** — สมจริงกับ priority\n\n## ขั้นตอนถัดไป\n\n- [Memory API](/docs/api/memory)\n- [Persistent LLM Agent](/docs/guides/persistent-llm-agent)\n- [Memory Tagging Strategy](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

แนวทางปฏิบัติที่ดีที่สุดสำหรับ Memory

\n

วิธีที่คุณจัดโครงสร้าง memory กำหนดว่ามันจะมีประโยชน์แค่ไหน คู่มือนี้ครอบคลุมรูปแบบสำหรับจัด category, tag และกำหนด priority ของ memory เพื่อให้ LLM recall ข้อมูลที่ถูกต้องในเวลาที่เหมาะสม

\n

Category: เลือกอันที่เฉพาะเจาะจงที่สุด

\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
Categoryใช้สำหรับตัวอย่าง
identityชื่อผู้ใช้, role, ข้อมูลติดต่อ"user_name": "Michael Schäfer"
preferenceสิ่งที่ชอบ/ไม่ชอบ, สไตล์การทำงาน"communication": "Prefers concise responses"
factfact ที่ตรวจสอบได้"office_location": "Berlin, Germany"
projectสถานะโปรเจกต์, การตัดสินใจ"project_synapse": "v1.5.0 deployed"
skillทักษะผู้ใช้"skill_python": "Advanced, 10+ years"
mistakeerror ในอดีตที่ต้องหลีกเลี่ยง"mistake_npm_version": "Always bump version"
contextcontext ที่เกี่ยวข้องกับ session"current_focus": "Working on docs system"
notenote อื่น ๆ"note_idea": "Try Redis for caching"
\n
เมื่อไม่แน่ใจ ใช้ `fact` สำหรับข้อมูลที่ตรวจสอบได้ และ `note` สำหรับทุกอย่างอื่น อย่า categorize มากเกินไป — `fact` ที่ชัดเจนดีกว่า `context` ที่สับสน

Key: identifier ที่มีความหมาย

\n

ฟิลด์ key เป็น identifier ของ memory ใช้ key ที่มีความหมายและคงที่:

\n

Key ที่ดี:

\n\n

Key ที่ไม่ดี:

\n\n

หลักการตั้งชื่อ key

\n\n

Tag: สำหรับการค้นหาและกรอง

\n

Tag เปิดใช้งานการกรองและค้นหาที่รวดเร็ว เพิ่ม 2-5 tag ต่อ memory:

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

รูปแบบ tag

\n\n
tag ไม่ sensitive ต่อตัวพิมพ์เล็ก/ใหญ่ ใช้ตัวพิมพ์เล็กเพื่อความสม่ำเสมอ

Priority: สมจริง

\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
Priorityใช้สำหรับ% ของ Memory
criticalตัวตนผู้ใช้, ข้อมูลทางกฎหมาย, การตัดสินใจย้อนกลับไม่ได้~5%
highโปรเจกต์ที่ใช้งาน, ค่ากำหนดสำคัญ~20%
normalfact, note, context ส่วนใหญ่~65%
lowชั่วคราว, รู้ไว้ก็ดี~10%
\n
อย่าทำเครื่องหมายทุกอย่างเป็น `critical` ถ้าทุกอย่าง critical ก็ไม่มีอะไร critical เลย สงวน `critical` สำหรับสิ่งที่จะก่อให้เกิดอันตรายจริงหากลืม

เมื่อใดเก็บ vs ไม่เก็บ

\n

เก็บเสมอ

\n\n

ไม่เก็บ

\n\n

การอัปเดต Memory

\n

POST /memory ด้วย category + key เดิมจะอัปเดต memory ที่มีอยู่:

\n
# 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")
ใช้ key ที่คงที่เพื่อให้อัปเดตได้โดยไม่สร้างซ้ำ LLM ควร POST ซ้ำ key เดิมเมื่อข้อมูลเปลี่ยน ไม่ใช่สร้าง memory ใหม่

วงจรชีวิต Memory

\n
Create → Active → Stale → Archive → Delete
\n

การทำความสะอาดเป็นคาบ

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

รูปแบบ: การสืบทอด Memory

\n

สำหรับ context แบบลำดับชั้น (โปรเจกต์ → โปรเจกต์ย่อย → task):

\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 เพื่อหา memory ที่เกี่ยวข้องทั้งหมด

\n

รูปแบบ: Decision Log

\n

เก็บการตัดสินใจพร้อมเหตุผลเพื่อให้ LLM ไม่ต้องถกเถียงใหม่:

\n
store("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")

รูปแบบ: การหลีกเลี่ยง Mistake

\n

เก็บ mistake พร้อมคำแนะนำการหลีกเลี่ยงเฉพาะ:

\n
store("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")

รูปแบบที่ควรหลีกเลี่ยง

\n

ขั้นตอนถัดไป

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