# Mô hình bộ nhớ
SUMMARY: Cách bộ nhớ được cấu trúc — danh mục, key, tag, mức ưu tiên, nguồn, xác minh.

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ớ
[CODE BLOCK]
Trường
| Trường | Loại | Bắt buộc | Mô tả |
|-------|------|----------|-------------|
|  | string | tự động | ID duy nhất (memxxx) |
|  | enum | ✅ | Một trong 8 danh mục |
|  | string | ✅ | Định danh ổn định (dùng để cập nhật) |
|  | string | ✅ | Nội dung bộ nhớ (bất kỳ văn bản nào) |
|  | string[] | – | Để tìm kiếm và lọc |
|  | enum | – | low, normal, high, critical (mặc định: normal) |
|  | enum | tự động | user, agent (ai lưu) |
|  | bool | tự động | Con người đã xác minh chưa? |
|  | float | – | 0.0 đến 1.0 (mặc định: 1.0 cho user, 0.7 cho agent) |
|  | timestamp | – | Khi nào quên bộ nhớ này |
|  | string | tự động | Mind nào sở hữu cái này |
|  | timestamp | tự động | Lần đầu lưu |
|  | timestamp | tự động | Lần sửa cuối |
Danh mục
Tám danh mục bao phủ các trường hợp sử dụng LLM agent phổ biến:
| Danh mục | Mục đích | Nội dung ví dụ |
|----------|---------|-----------------|
|  | Người dùng là ai | "User is Michael Schäfer, software engineer in Berlin" |
|  | Sở thích người dùng | "Prefers concise technical responses" |
|  | Sự kiện có thể kiểm chứng | "Office is in Berlin, timezone Europe/Berlin" |
|  | Trạng thái dự án | "Synapse v1.5.0 deployed, working on v1.6.0 docs" |
|  | Kỹ năng người dùng | "Advanced Python, 10+ years" |
|  | Lỗi trong quá khứ | "Forgot to bump npm version — CI failed" |
|  | Ngữ cảnh phiên | "Currently reviewing PR #42" |
|  | Ghi chú linh tinh | "Try Redis for caching next sprint" |
Key: Định danh ổn định
Trường  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.
[CODE BLOCK]
Quy tắc key:
- Phải duy nhất trong (category, mind)
- Sử dụng 
- Tiền tố với danh mục để rõ ràng: , 
- 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:
[CODE BLOCK]
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
| Ưu tiên | Khi nào sử dụng | Hành vi thu hồi |
|----------|-------------|-----------------|
|  | Nhận dạng, pháp lý, không thể đảo ngược | Luôn ở đầu thu hồi |
|  | Dự án đang hoạt động, sở thích chính | Nổi bật trong thu hồi |
|  | Hầu hết bộ nhớ (mặc định) | Thứ tự thu hồi chuẩn |
|  | Tạm thời, tốt nếu biết | Có thể được tóm tắt |
 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 :
-  — được lưu bởi con người (qua JWT hoặc giao diện con người)
-  — được lưu bởi LLM agent (qua Mind Key)
Điều này ảnh hưởng:
- Xác minh: bộ nhớ  được tự động xác minh, bộ nhớ  thì không
- Độ tin cậy:  mặc định 1.0,  0.7
- Thu hồi:  đánh dấu bộ nhớ chưa xác minh với "(unverified)"
> [!NOTE]
> Hãy đối xử với bộ nhớ nguồn  với sự hoài nghi phù hợp. Chúng có thể
> được suy luận hoặc giả định thay vì được người dùng phát biểu trực tiếp.
Xác minh
Cờ  cho biết con người đã xác nhận bộ nhớ:
- Bộ nhớ : tự động xác minh ()
- Bộ nhớ : mặc định chưa xác minh ()
Xác minh bộ nhớ qua:
[CODE BLOCK]
> [!NOTE]
> Xác minh yêu cầu JWT (xác thực con người), không phải Mind Key (xác thực
> agent). Điều này đảm bảo chỉ con người có thể đánh dấu bộ nhớ là đã xác minh.
Độ tin cậy
Trường  (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:
[CODE BLOCK]
Hết hạn
Đặt  cho bộ nhớ nhạy cảm với thời gian:
[CODE BLOCK]
Bộ nhớ hết hạn không được  trả về (nhưng vẫn tồn tại trong DB).
Sử dụng  để xem bộ nhớ sắp hết hạn.
Vòng đời bộ nhớ
[CODE BLOCK]
Hành vi thu hồi
 trả về tóm tắt văn bản thuần được tối ưu cho ngữ cảnh LLM:
[CODE BLOCK]
- 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 
- 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