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

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

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

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

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

Key ที่ดี:

• user_name
• project_synapse_status
• preference_communication_style
• mistake_npm_version_bump

Key ที่ไม่ดี:

• mem_001 (ไม่มีความหมาย)
• temp (ไม่บรรยาย)
• 2026-06-27-note (วันที่ไม่ช่วย recall)

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

• snake_case (ตัวพิมพ์เล็กด้วย underscore)
• นำหน้าด้วย category: preference_*, project_*, mistake_*
• ใช้คำนามที่บรรยาย ไม่ใช่กริยา
• ความยาวไม่เกิน 50 ตัวอักษร

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

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

{
  "category": "project",
  "key": "project_synapse_status",
  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.",
  "tags": ["synapse", "deployment", "status", "v1.5.0"]
}

รูปแบบ tag

• ชื่อโปรเจกต์: synapse, synapse-mcp, synapse-chat
• หัวข้อ: deployment, ci, database, auth
• สถานะ: active, completed, blocked
• ตัวบ่งชี้ priority: urgent, long-term

Priority: สมจริง

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

เก็บเสมอ

• ตัวตนผู้ใช้ (ชื่อ, email, role)
• ค่ากำหนดระยะยาว
• การตัดสินใจและเหตุผลของโปรเจกต์
• mistake และบทเรียนในอดีต
• คำมั่นสัญญาที่ให้กับผู้ใช้

ไม่เก็บ

• state ชั่วคราว (ใช้ variable แทน)
• ประวัติการสนทนาแบบ verbatim (ระบบแช็ตจัดการสิ่งนี้)
• ข้อมูล sensitive (รหัสผ่าน, API key)
• fact ที่ derive ง่าย (วันที่ปัจจุบัน, เนื้อหาไฟล์)
• context ชั่วคราว (ใช้ category context พร้อม priority ต่ำ)

การอัปเดต Memory

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

# Initial store
store("project", "project_synapse_status", "v1.4.0 deployed", priority="high")

# Later: update with same key
store("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")

วงจรชีวิต Memory

Create → Active → Stale → Archive → Delete

• Create: POST /memory พร้อม context เต็ม
• Active: recall บ่อย, อัปเดตตามต้องการ
• Stale: ยังเกี่ยวข้องแต่ไม่ได้ใช้งาน (priority ต่ำกว่า?)
• Archive: ตั้ง priority เป็น low, เก็บเพื่ออ้างอิงทางประวัติศาสตร์
• Delete: DELETE /memory/:id เมื่อไม่เกี่ยวข้องอีก

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

# Find memories not updated in 90 days
old_memories = requests.get(
    f"{URL}/memory/search?q=*",
    headers={"Authorization": f"Bearer {KEY}"}
)

for mem in old_memories["results"]:
    if is_stale(mem, days=90):
        # Either delete or lower priority
        if is_obsolete(mem):
            delete_memory(mem["id"])
        else:
            update_memory(mem["id"], priority="low")

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

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

# Parent project
store("project", "project_synapse", "Main Synapse project", 
      tags=["synapse", "parent"], priority="high")

# Sub-project (tags link to parent)
store("project", "project_synapse_docs", "Docs system for Synapse",
      tags=["synapse", "docs", "synapse-parent"], priority="high")

# Specific task (tags link to sub-project)
store("project", "task_docs_loader", "Implement docs-loader.ts",
      tags=["synapse", "docs", "task"], priority="normal")

LLM สามารถค้นหา q=synapse+docs เพื่อหา memory ที่เกี่ยวข้องทั้งหมด

รูปแบบ: Decision Log

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

store("fact", "decision_postgres_over_sqlite",
      "Chose PostgreSQL over SQLite for production. Reason: concurrent writes, "
      "FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.",
      tags=["decision", "database", "postgres", "sqlite"],
      priority="high")

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

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

store("mistake", "mistake_forget_version_bump",
      "Forgot to bump package.json version after changes. npm publish failed. "
      "FIX: Always run `npm version patch` before pushing. "
      "CI fails with 'version already exists' if you forget.",
      tags=["npm", "ci", "publish", "version"],
      priority="high")

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

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

• Memory API
• Persistent LLM Agent
• Memory Tagging Strategy