{"title":"โมเดล Memory","slug":"memory-model","category":"concepts","summary":"วิธีที่ memory ถูกจัดโครงสร้าง — category, key, tag, priority, source, การยืนยัน","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":575,"read_minutes":3,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# โมเดล Memory\n\nโมเดล memory ของ Synapse ออกแบบมาเพื่อ LLM agent — มีโครงสร้างเพียงพอสำหรับ recall ที่เชื่อถือได้ และยืดหยุ่นพอสำหรับโดเมนใด ๆ\n\n## กายวิภาคของ Memory\n\n```json\n{\n \"id\": \"mem_abc123\",\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed on vps1. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"v1.5.0\"],\n \"priority\": \"high\",\n \"source\": \"agent\",\n \"verified\": false,\n \"confidence\": 0.85,\n \"expires_at\": null,\n \"mind_id\": \"m_xyz789\",\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n## ฟิลด์\n\n| Field | Type | Required | คำอธิบาย |\n|-------|------|----------|-------------|\n| `id` | string | auto | ID ที่ไม่ซ้ำ (mem_xxx) |\n| `category` | enum | ✅ | หนึ่งใน 8 category |\n| `key` | string | ✅ | identifier ที่คงทย (ใช้สำหรับอัปเดต) |\n| `content` | string | ✅ | เนื้อหา memory (text ใด ๆ) |\n| `tags` | string[] | – | สำหรับการค้นหาและกรอง |\n| `priority` | enum | – | low, normal, high, critical (ค่าเริ่มต้น: normal) |\n| `source` | enum | auto | user, agent (ใครเป็นผู้เก็บ) |\n| `verified` | bool | auto | human ยืนยันหรือยัง? |\n| `confidence` | float | – | 0.0 ถึง 1.0 (ค่าเริ่มต้น: 1.0 สำหรับ user, 0.7 สำหรับ agent) |\n| `expires_at` | timestamp | – | เมื่อไรจะลืม memory นี้ |\n| `mind_id` | string | auto | mind ใดเป็นเจ้าของ |\n| `created_at` | timestamp | auto | เก็บครั้งแรก |\n| `updated_at` | timestamp | auto | แก้ไขล่าสุด |\n\n## Category\n\nแปด category ครอบคลุมกรณีใช้งาน LLM agent ทั่วไป:\n\n| Category | วัตถุประสงค์ | เนื้อหาตัวอย่าง |\n|----------|---------|-----------------|\n| `identity` | ผู้ใช้คือใคร | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | ค่ากำหนดผู้ใช้ | \"Prefers concise technical responses\" |\n| `fact` | fact ที่ตรวจสอบได้ | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | สถานะโปรเจกต์ | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | ทักษะผู้ใช้ | \"Advanced Python, 10+ years\" |\n| `mistake` | error ในอดีต | \"Forgot to bump npm version — CI failed\" |\n| `context` | context ของ session | \"Currently reviewing PR #42\" |\n| `note` | note อื่น ๆ | \"Try Redis for caching next sprint\" |\n\n## Key: identifier ที่คงที่\n\nฟิลด์ `key` สำคัญมาก — เป็นวิธีที่คุณอัปเดต memory โดยไม่สร้างซ้ำ\n\n```python\n# First store\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**กฎของ key:**\n\n- ต้องไม่ซ้ำใน (category, mind)\n- ใช้ `snake_case`\n- นำหน้าด้วย category เพื่อความชัดเจน: `preference_communication`, `mistake_npm_version`\n- รักษาให้คงที่ — อย่าเปลี่ยน key หลังสร้าง\n\n## Tag: สำหรับการค้นหา\n\nTag เปิดใช้งานการกรองและค้นหาที่รวดเร็ว:\n\n```bash\n# Find all memories with tag \"docker\"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker\n```\n\n**แนวทางปฏิบัติที่ดีที่สุดสำหรับ tag:**\n\n- 2-5 tag ต่อ memory (อย่า tag มากเกินไป)\n- ตัวพิมพ์เล็กเพื่อความสม่ำเสมอ\n- ใช้ชื่อโปรเจกต์, หัวข้อ, เทคโนโลยี\n- tag ไม่ sensitive ต่อตัวพิมพ์เล็ก/ใหญ่\n\n## ระดับ Priority\n\n| Priority | เมื่อใช้ | พฤติกรรม Recall |\n|----------|-------------|-----------------|\n| `critical` | ตัวตน, ทางกฎหมาย, ย้อนกลับไม่ได้ | อยู่บนสุดของ recall เสมอ |\n| `high` | โปรเจกต์ที่ใช้งานอยู่, ค่ากำหนดหลัก | เด่นใน recall |\n| `normal` | memory ส่วนใหญ่ (ค่าเริ่มต้น) | ลำดับ recall มาตรฐาน |\n| `low` | ชั่วคราว, รู้ไว้ก็ดี | อาจถูกสรุป |\n\n`/memory/recall` เรียงตาม priority (critical ก่อน) แล้วตามความใหม่\n\n## Source: User vs Agent\n\nmemory ถูก tag ด้วย `source`:\n\n- `user` — เก็บโดย human (ผ่าน JWT หรือ human UI)\n- `agent` — เก็บโดย LLM agent (ผ่าน Mind Key)\n\nสิ่งนี้มีผลต่อ:\n\n- **การยืนยัน:** memory `user` ถูก verify อัตโนมัติ, memory `agent` ไม่ได้\n- **ความมั่นใจ:** `user` ค่าเริ่มต้น 1.0, `agent` ค่าเริ่มต้น 0.7\n- **Recall:** `/memory/recall` ทำเครื่องหมาย memory ที่ยังไม่ verify ด้วย \"(unverified)\"\n\n> [!NOTE]\n> ปฏิบัติต่อ memory source `agent` ด้วยความสงสัยพอสมควร อาจเป็นการอนุมานหรือสมมติฐาน ไม่ใช่ที่ผู้ใช้ระบุโดยตรง\n\n## การยืนยัน\n\nflag `verified` บ่งชี้ว่า human ได้ยืนยัน memory แล้ว:\n\n- memory `user`: auto-verified (`true`)\n- memory `agent`: ค่าเริ่มต้น unverified (`false`)\n\nยืนยัน memory ผ่าน:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n> [!NOTE]\n> การยืนยันต้องใช้ JWT (human auth) ไม่ใช่ Mind Key (agent auth) สิ่งนี้รับประกันว่าเฉพาะ human เท่านั้นที่ทำเครื่องหมาย memory ว่า verified\n\n## ความมั่นใจ\n\nฟิลด์ `confidence` (0.0 ถึง 1.0) บ่งชี้ความน่าเชื่อถือของ memory:\n\n- 1.0 — ระบุโดยตรงโดยผู้ใช้\n- 0.7 — อนุมานโดย agent\n- 0.5 — ไม่แน่นอน ต้องตรวจสอบ\n- 0.0 — สงสัยอย่างชัดเจน\n\nตั้งค่า confidence เมื่อเก็บ:\n\n```json\n{\n \"category\": \"preference\",\n \"key\": \"prefers_dark_mode\",\n \"content\": \"User seems to prefer dark mode (based on their IDE screenshots)\",\n \"confidence\": 0.5,\n \"source\": \"agent\"\n}\n```\n\n## การหมดอายุ\n\nตั้ง `expires_at` สำหรับ memory ที่ sensitive ต่อเวลา:\n\n```json\n{\n \"category\": \"context\",\n \"key\": \"current_meeting_topic\",\n \"content\": \"Discussing Q3 roadmap\",\n \"expires_at\": \"2026-06-28T00:00:00Z\"\n}\n```\n\nmemory ที่หมดอายุจะไม่ถูกส่งกลับโดย `/memory/recall` (แต่ยังมีใน DB) ใช้ `/memory/expiring?within=7d` เพื่อดู memory ที่จะหมดอายุเร็ว ๆ นี้\n\n## วงจรชีวิต Memory\n\n```\n ┌─────────────────┐\n │ Create │\n │ POST /memory │\n └────────┬────────┘\n │\n ▼\n ┌─────────────────┐\n │ Active │ ◀──── PUT /memory/:id (update)\n │ (in recall) │\n └────────┬────────┘\n │\n ┌────────────┼────────────┐\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ Expired │ │ Verified │ │ Deleted │\n │ (in DB) │ │ (flag) │ │ (gone) │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## พฤติกรรม Recall\n\n`GET /memory/recall` ส่งกลับสรุปแบบ plain-text ที่ปรับให้เหมาะกับ LLM context:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH) [verified]\n communication_style\n Prefers concise technical responses\n Tags: communication\n\n[003] project (HIGH) [unverified]\n synapse_status\n v1.5.0 deployed, working on v1.6.0 docs\n Tags: synapse, deployment\n\n...\n```\n\n- เรียงตาม priority (critical → low) แล้วตามความใหม่\n- memory ที่ยังไม่ verify ทำเครื่องหมายด้วย `[unverified]`\n- รวม tag เพื่อ context\n- Plain text (ไม่ต้อง parse JSON)\n\n## ขั้นตอนถัดไป\n\n- [Memory API](/docs/api/memory)\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n- [FTS5 Search](/docs/concepts/fts5-search)\n","content_html":"

โมเดล Memory

\n

โมเดล memory ของ Synapse ออกแบบมาเพื่อ LLM agent — มีโครงสร้างเพียงพอสำหรับ recall ที่เชื่อถือได้ และยืดหยุ่นพอสำหรับโดเมนใด ๆ

\n

กายวิภาคของ Memory

\n
{\n  "id": "mem_abc123",\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed on vps1. CI green.",\n  "tags": ["synapse", "deployment", "v1.5.0"],\n  "priority": "high",\n  "source": "agent",\n  "verified": false,\n  "confidence": 0.85,\n  "expires_at": null,\n  "mind_id": "m_xyz789",\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\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\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
FieldTypeRequiredคำอธิบาย
idstringautoID ที่ไม่ซ้ำ (mem_xxx)
categoryenum✅หนึ่งใน 8 category
keystring✅identifier ที่คงทย (ใช้สำหรับอัปเดต)
contentstring✅เนื้อหา memory (text ใด ๆ)
tagsstring[]–สำหรับการค้นหาและกรอง
priorityenum–low, normal, high, critical (ค่าเริ่มต้น: normal)
sourceenumautouser, agent (ใครเป็นผู้เก็บ)
verifiedboolautohuman ยืนยันหรือยัง?
confidencefloat–0.0 ถึง 1.0 (ค่าเริ่มต้น: 1.0 สำหรับ user, 0.7 สำหรับ agent)
expires_attimestamp–เมื่อไรจะลืม memory นี้
mind_idstringautomind ใดเป็นเจ้าของ
created_attimestampautoเก็บครั้งแรก
updated_attimestampautoแก้ไขล่าสุด
\n

Category

\n

แปด category ครอบคลุมกรณีใช้งาน LLM agent ทั่วไป:

\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ผู้ใช้คือใคร"User is Michael Schäfer, software engineer in Berlin"
preferenceค่ากำหนดผู้ใช้"Prefers concise technical responses"
factfact ที่ตรวจสอบได้"Office is in Berlin, timezone Europe/Berlin"
projectสถานะโปรเจกต์"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillทักษะผู้ใช้"Advanced Python, 10+ years"
mistakeerror ในอดีต"Forgot to bump npm version — CI failed"
contextcontext ของ session"Currently reviewing PR #42"
notenote อื่น ๆ"Try Redis for caching next sprint"
\n

Key: identifier ที่คงที่

\n

ฟิลด์ key สำคัญมาก — เป็นวิธีที่คุณอัปเดต memory โดยไม่สร้างซ้ำ

\n
# First store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

กฎของ key:

\n\n

Tag: สำหรับการค้นหา

\n

Tag เปิดใช้งานการกรองและค้นหาที่รวดเร็ว:

\n
# Find all memories with tag "docker"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker

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

\n\n

ระดับ 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เมื่อใช้พฤติกรรม Recall
criticalตัวตน, ทางกฎหมาย, ย้อนกลับไม่ได้อยู่บนสุดของ recall เสมอ
highโปรเจกต์ที่ใช้งานอยู่, ค่ากำหนดหลักเด่นใน recall
normalmemory ส่วนใหญ่ (ค่าเริ่มต้น)ลำดับ recall มาตรฐาน
lowชั่วคราว, รู้ไว้ก็ดีอาจถูกสรุป
\n

/memory/recall เรียงตาม priority (critical ก่อน) แล้วตามความใหม่

\n

Source: User vs Agent

\n

memory ถูก tag ด้วย source:

\n\n

สิ่งนี้มีผลต่อ:

\n\n
ปฏิบัติต่อ memory source `agent` ด้วยความสงสัยพอสมควร อาจเป็นการอนุมานหรือสมมติฐาน ไม่ใช่ที่ผู้ใช้ระบุโดยตรง

การยืนยัน

\n

flag verified บ่งชี้ว่า human ได้ยืนยัน memory แล้ว:

\n\n

ยืนยัน memory ผ่าน:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
การยืนยันต้องใช้ JWT (human auth) ไม่ใช่ Mind Key (agent auth) สิ่งนี้รับประกันว่าเฉพาะ human เท่านั้นที่ทำเครื่องหมาย memory ว่า verified

ความมั่นใจ

\n

ฟิลด์ confidence (0.0 ถึง 1.0) บ่งชี้ความน่าเชื่อถือของ memory:

\n\n

ตั้งค่า confidence เมื่อเก็บ:

\n
{\n  "category": "preference",\n  "key": "prefers_dark_mode",\n  "content": "User seems to prefer dark mode (based on their IDE screenshots)",\n  "confidence": 0.5,\n  "source": "agent"\n}

การหมดอายุ

\n

ตั้ง expires_at สำหรับ memory ที่ sensitive ต่อเวลา:

\n
{\n  "category": "context",\n  "key": "current_meeting_topic",\n  "content": "Discussing Q3 roadmap",\n  "expires_at": "2026-06-28T00:00:00Z"\n}

memory ที่หมดอายุจะไม่ถูกส่งกลับโดย /memory/recall (แต่ยังมีใน DB) ใช้ /memory/expiring?within=7d เพื่อดู memory ที่จะหมดอายุเร็ว ๆ นี้

\n

วงจรชีวิต Memory

\n
                  ┌─────────────────┐\n                  │     Create      │\n                  │  POST /memory   │\n                  └────────┬────────┘\n                           │\n                           ▼\n                  ┌─────────────────┐\n                  │     Active      │ ◀──── PUT /memory/:id (update)\n                  │  (in recall)    │\n                  └────────┬────────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n        ┌──────────┐ ┌──────────┐ ┌──────────┐\n        │ Expired  │ │ Verified │ │ Deleted  │\n        │ (in DB)  │ │ (flag)   │ │ (gone)   │\n        └──────────┘ └──────────┘ └──────────┘

พฤติกรรม Recall

\n

GET /memory/recall ส่งกลับสรุปแบบ plain-text ที่ปรับให้เหมาะกับ LLM context:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH) [verified]\n  communication_style\n  Prefers concise technical responses\n  Tags: communication\n\n[003] project (HIGH) [unverified]\n  synapse_status\n  v1.5.0 deployed, working on v1.6.0 docs\n  Tags: synapse, deployment\n\n...
\n

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

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