{"title":"Thực hành tốt nhất về bộ nhớ","slug":"memory-best-practices","category":"guides","summary":"Cách cấu trúc bộ nhớ cho thu hồi hiệu quả — danh mục, key, tag, mức ưu tiên.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":847,"read_minutes":4,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Thực hành tốt nhất về bộ nhớ\n\nCách bạn cấu trúc bộ nhớ xác định độ hữu ích của chúng. Hướng dẫn này bao phủ\nmẫu cho việc phân danh mục, gắn tag và ưu tiên bộ nhớ để LLM có thể thu hồi\nthông tin đúng vào thời điểm đúng.\n\n## Danh mục: Chọn cái cụ thể nhất\n\n| Danh mục | Dùng cho | Ví dụ |\n|----------|---------|---------|\n| `identity` | Tên người dùng, vai trò, thông tin liên hệ | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | Thích, không thích, phong cách làm việc | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | Sự kiện có thể kiểm chứng | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | Trạng thái dự án, quyết định | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | Kỹ năng người dùng | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | Lỗi quá khứ để tránh | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | Ngữ cảnh liên quan phiên | `\"current_focus\": \"Working on docs system\"` |\n| `note` | Ghi chú linh tinh | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> Khi nghi ngờ, sử dụng `fact` cho thông tin có thể kiểm chứng và `note` cho\n> mọi thứ khác. Không phân danh mục quá mức — tốt hơn có một `fact` rõ ràng\n> hơn một `context` gây nhầm lẫn.\n\n## Key: Định danh ý nghĩa\n\nTrường `key` là định danh của bộ nhớ. Sử dụng key ý nghĩa, ổn định:\n\n**Key tốt:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Key xấu:**\n- `mem_001` (không ý nghĩa)\n- `temp` (không mô tả)\n- `2026-06-27-note` (ngày không giúp thu hồi)\n\n### Quy ước đặt tên key\n\n- `snake_case` (chữ thường với dấu gạch dưới)\n- Tiền tố với danh mục: `preference_*`, `project_*`, `mistake_*`\n- Sử dụng danh từ mô tả, không động từ\n- Giữ dưới 50 ký tự\n\n## Tag: Dành cho tìm kiếm và lọc\n\nTag cho phép lọc và tìm kiếm nhanh. Thêm 2-5 tag mỗi bộ nhớ:\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### Mẫu tag\n\n- **Tên dự án**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **Chủ đề**: `deployment`, `ci`, `database`, `auth`\n- **Trạng thái**: `active`, `completed`, `blocked`\n- **Chỉ báo ưu tiên**: `urgent`, `long-term`\n\n> [!NOTE]\n> Tag không phân biệt chữ hoa chữ thường. Sử dụng chữ thường để nhất quán.\n\n## Mức ưu tiên: Thực tế\n\n| Ưu tiên | Dùng cho | % Bộ nhớ |\n|----------|---------|---------------|\n| `critical` | Nhận dạng người dùng, thông tin pháp lý, quyết định không thể đảo ngược | ~5% |\n| `high` | Dự án đang hoạt động, sở thích quan trọng | ~20% |\n| `normal` | Hầu hết sự kiện, ghi chú, ngữ cảnh | ~65% |\n| `low` | Tạm thời, tốt nếu biết | ~10% |\n\n> [!WARNING]\n> Không đánh dấu mọi thứ `critical`. Nếu mọi thứ là critical, không có gì là\n> critical cả. Dự trữ `critical` cho những thứ sẽ gây hại thực sự nếu quên.\n\n## Khi nào lưu so với không lưu\n\n### Luôn lưu\n\n- Nhận dạng người dùng (tên, email, vai trò)\n- Sở thích dài hạn\n- Quyết định dự án và lý do\n- Lỗi quá khứ và bài học\n- Cam kết với người dùng\n\n### Không lưu\n\n- Trạng thái tạm thời (sử dụng biến thay thế)\n- Lịch sử hội thoại nguyên văn (hệ thống chat xử lý điều này)\n- Dữ liệu nhạy cảm (mật khẩu, API key)\n- Sự kiện dễ dàng suy ra (ngày hiện tại, nội dung tệp)\n- Ngữ cảnh tạm thời (sử dụng danh mục `context` với ưu tiên thấp)\n\n## Cập nhật bộ nhớ\n\nPOST `/memory` với cùng `category` + `key` cập nhật bộ nhớ hiện có:\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> Sử dụng key ổn định để bạn có thể cập nhật mà không tạo bản trùng lặp. LLM\n> nên POST lại cùng key khi thông tin thay đổi, không tạo bộ nhớ mới.\n\n## Vòng đời bộ nhớ\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory với ngữ cảnh đầy đủ\n- **Active**: Thu hồi thường xuyên, cập nhật khi cần\n- **Stale**: Vẫn liên quan nhưng không được sử dụng tích cực (ưu tiên thấp hơn?)\n- **Archive**: Đặt ưu tiên thành `low`, giữ cho tham chiếu lịch sử\n- **Delete**: DELETE /memory/:id khi không còn liên quan\n\n### Dọn dẹp định kỳ\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## Mẫu: Kế thừa bộ nhớ\n\nCho ngữ cảnh phân cấp (dự án → dự án con → tác vụ):\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 có thể sau đó tìm `q=synapse+docs` để tìm tất cả bộ nhớ liên quan.\n\n## Mẫu: Nhật ký quyết định\n\nLưu quyết định với lý do để LLM không tái thẩm lại chúng:\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## Mẫu: Tránh lỗi\n\nLưu lỗi với hướng dẫn tránh cụ thể:\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## Mẫu chống cần tránh\n\n> [!WARNING]\n> - **Lưu nhật ký hội thoại** — hệ thống chat xử lý điều này\n> - **Lưu toàn bộ tệp** — sử dụng script store hoặc lưu trữ bên ngoài\n> - **Lưu trạng thái tạm thời** — sử dụng biến\n> - **Lưu bí mật** — sử dụng biến môi trường\n> - **Trùng lặp bộ nhớ** — sử dụng key ổn định\n> - **Gắn tag quá mức** — 2-5 tag mỗi bộ nhớ là lý tưởng\n> - **Mọi thứ là critical** — thực tế với ưu tiên\n\n## Bước tiếp theo\n\n- [Memory API](/docs/api/memory)\n- [LLM Agent cố định](/docs/guides/persistent-llm-agent)\n- [Chiến lược gắn tag bộ nhớ](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

Thực hành tốt nhất về bộ nhớ

\n

Cách bạn cấu trúc bộ nhớ xác định độ hữu ích của chúng. Hướng dẫn này bao phủ\nmẫu cho việc phân danh mục, gắn tag và ưu tiên bộ nhớ để LLM có thể thu hồi\nthông tin đúng vào thời điểm đúng.

\n

Danh mục: Chọn cái cụ thể nhất

\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
Danh mụcDùng choVí dụ
identityTên người dùng, vai trò, thông tin liên hệ"user_name": "Michael Schäfer"
preferenceThích, không thích, phong cách làm việc"communication": "Prefers concise responses"
factSự kiện có thể kiểm chứng"office_location": "Berlin, Germany"
projectTrạng thái dự án, quyết định"project_synapse": "v1.5.0 deployed"
skillKỹ năng người dùng"skill_python": "Advanced, 10+ years"
mistakeLỗi quá khứ để tránh"mistake_npm_version": "Always bump version"
contextNgữ cảnh liên quan phiên"current_focus": "Working on docs system"
noteGhi chú linh tinh"note_idea": "Try Redis for caching"
\n
Khi nghi ngờ, sử dụng `fact` cho thông tin có thể kiểm chứng và `note` cho\nmọi thứ khác. Không phân danh mục quá mức — tốt hơn có một `fact` rõ ràng\nhơn một `context` gây nhầm lẫn.

Key: Định danh ý nghĩa

\n

Trường key là định danh của bộ nhớ. Sử dụng key ý nghĩa, ổn định:

\n

Key tốt:

\n\n

Key xấu:

\n\n

Quy ước đặt tên key

\n\n

Tag: Dành cho tìm kiếm và lọc

\n

Tag cho phép lọc và tìm kiếm nhanh. Thêm 2-5 tag mỗi bộ nhớ:

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

Mẫu tag

\n\n
Tag không phân biệt chữ hoa chữ thường. Sử dụng chữ thường để nhất quán.

Mức ưu tiên: Thực tế

\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
Ưu tiênDùng cho% Bộ nhớ
criticalNhận dạng người dùng, thông tin pháp lý, quyết định không thể đảo ngược~5%
highDự án đang hoạt động, sở thích quan trọng~20%
normalHầu hết sự kiện, ghi chú, ngữ cảnh~65%
lowTạm thời, tốt nếu biết~10%
\n
Không đánh dấu mọi thứ `critical`. Nếu mọi thứ là critical, không có gì là\ncritical cả. Dự trữ `critical` cho những thứ sẽ gây hại thực sự nếu quên.

Khi nào lưu so với không lưu

\n

Luôn lưu

\n\n

Không lưu

\n\n

Cập nhật bộ nhớ

\n

POST /memory với cùng category + key cập nhật bộ nhớ hiện có:

\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")
Sử dụng key ổn định để bạn có thể cập nhật mà không tạo bản trùng lặp. LLM\nnên POST lại cùng key khi thông tin thay đổi, không tạo bộ nhớ mới.

Vòng đời bộ nhớ

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

Dọn dẹp định kỳ

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

Mẫu: Kế thừa bộ nhớ

\n

Cho ngữ cảnh phân cấp (dự án → dự án con → tác vụ):

\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 có thể sau đó tìm q=synapse+docs để tìm tất cả bộ nhớ liên quan.

\n

Mẫu: Nhật ký quyết định

\n

Lưu quyết định với lý do để LLM không tái thẩm lại chúng:

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

Mẫu: Tránh lỗi

\n

Lưu lỗi với hướng dẫn tránh cụ thể:

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

Mẫu chống cần tránh

\n

Bước tiếp theo

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