Mô hình bộ nhớ

Mô hình bộ nhớ của Synapse được thiết kế cho LLM agent — đủ cấu trúc để thu hồi tin cậy, đủ linh hoạt cho bất kỳ lĩnh vực nào.

Giải phẫu bộ nhớ

{
  "id": "mem_abc123",
  "category": "project",
  "key": "project_synapse_status",
  "content": "Synapse v1.5.0 deployed on vps1. CI green.",
  "tags": ["synapse", "deployment", "v1.5.0"],
  "priority": "high",
  "source": "agent",
  "verified": false,
  "confidence": 0.85,
  "expires_at": null,
  "mind_id": "m_xyz789",
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}

Trường

Danh mục

Tám danh mục bao phủ các trường hợp sử dụng LLM agent phổ biến:

Key: Định danh ổn định

Trường key rất quan trọng — đó là cách bạn cập nhật bộ nhớ mà không tạo bản trùng lặp.

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

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

Quy tắc key:

• Phải duy nhất trong (category, mind)
• Sử dụng snake_case
• Tiền tố với danh mục để rõ ràng: preference_communication, mistake_npm_version
• Giữ ổn định — không thay đổi key sau khi tạo

Tag: Dành cho tìm kiếm

Tag cho phép lọc và tìm kiếm nhanh:

# Find all memories with tag "docker"
GET /memory/by-tag?tag=docker

# FTS5 search within tagged subset
GET /memory/search?q=swarm&tag=docker

Thực hành tốt nhất về tag:

• 2-5 tag mỗi bộ nhớ (không gắn tag quá mức)
• Chữ thường để nhất quán
• Sử dụng tên dự án, chủ đề, công nghệ
• Tag không phân biệt chữ hoa chữ thường

Mức ưu tiên

/memory/recall sắp xếp theo ưu tiên (critical trước), sau đó theo gần đây.

Nguồn: User so với Agent

Bộ nhớ được gắn source:

• user — được lưu bởi con người (qua JWT hoặc giao diện con người)
• agent — được lưu bởi LLM agent (qua Mind Key)

Điều này ảnh hưởng:

• Xác minh: bộ nhớ user được tự động xác minh, bộ nhớ agent thì không
• Độ tin cậy: user mặc định 1.0, agent 0.7
• Thu hồi: /memory/recall đánh dấu bộ nhớ chưa xác minh với "(unverified)"

Xác minh

Cờ verified cho biết con người đã xác nhận bộ nhớ:

• Bộ nhớ user: tự động xác minh (true)
• Bộ nhớ agent: mặc định chưa xác minh (false)

Xác minh bộ nhớ qua:

curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \
  -H "Authorization: Bearer YOUR_JWT"

Độ tin cậy

Trường confidence (0.0 đến 1.0) cho biết bộ nhớ đáng tin cậy đến đâu:

• 1.0 — được người dùng phát biểu trực tiếp
• 0.7 — được agent suy luận
• 0.5 — không chắc chắn, cần xác minh
• 0.0 — bị nghi ngờ rõ ràng

Đặt độ tin cậy khi lưu:

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

Hết hạn

Đặt expires_at cho bộ nhớ nhạy cảm với thời gian:

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

Bộ nhớ hết hạn không được /memory/recall trả về (nhưng vẫn tồn tại trong DB). Sử dụng /memory/expiring?within=7d để xem bộ nhớ sắp hết hạn.

Vòng đời bộ nhớ

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

Hành vi thu hồi

GET /memory/recall trả về tóm tắt văn bản thuần được tối ưu cho ngữ cảnh LLM:

Mind: Michael's Mind
Memories: 12 total (10 verified, 2 unverified)

[001] identity (CRITICAL) [verified]
  user_name
  Michael Schäfer
  Tags: person, identity

[002] preference (HIGH) [verified]
  communication_style
  Prefers concise technical responses
  Tags: communication

[003] project (HIGH) [unverified]
  synapse_status
  v1.5.0 deployed, working on v1.6.0 docs
  Tags: synapse, deployment

...

• Sắp xếp theo ưu tiên (critical → low), sau đó theo gần đây
• Bộ nhớ chưa xác minh được đánh dấu [unverified]
• Tag được bao gồm cho ngữ cảnh
• Văn bản thuần (không cần phân tích JSON)

Bước tiếp theo

• Memory API
• Thực hành tốt nhất về bộ nhớ
• Tìm kiếm FTS5