---

Mới nhất: Team Memory Beta đang phát triển nhanh chóng — hãy cài đặt nó và bắt đầu khám phá sau vài phút.

Cài đặt

Bắt đầu cả ba dịch vụ cùng một lúc (memory-core + memory-hub + proxy):

git clone https://github.com/Tencent/TencentDB-Agent-Memory.git
cd TencentDB-Agent-Memory/deploy/global-images
cp .env.example .env
$EDITOR .env       # Fill in two sets of LLM parameters (memory group + proxy group)
./start-all.sh     # Launch everything with one command; when finished, it prints a one-liner you can paste directly into Claude

Mở bảng điều khiển: HTTP://localhost:8125.

Tài liệu cài đặt hoàn chỉnh (triển khai Memory Hub độc lập, sử dụng Proxy + Claude Code / CodeBuddy, dừng và dọn dẹp, tham chiếu cổng, v.v.) có sẵn trong CÀI ĐẶT.md (中文: INSTALL_CN.md).

Di chuyển dữ liệu từ phiên bản cũ hơn

Nếu bạn đang sử dụng bản phát hành cũ hơn (v1.x / v0.x) và muốn chuyển dữ liệu hiện có của mình sang v2.0.0+, chúng tôi cung cấp công cụ di chuyển:

Xem Công cụ di chuyển dữ liệu (v2 → v3) để sử dụng đầy đủ và cờ. Cài đặt mới có thể bỏ qua điều này.

Tất cả các đại lý chia sẻ cùng một máy chủ bộ nhớ

Một Proxy, giao thức không thay đổi, tích hợp mã 0 — trỏ URL cơ sở của Tác nhân tới Proxy và thế là xong. Không cần plugin, hook hoặc máy chủ MCP.

DeepSeek Dây nịt	Claude Code	Codex	CodeBuddy
WorkBuddy	Hermes	OpenClaw	Sắp có thêm nhiều khung công tác...

Xem CÀI ĐẶT.md để biết các bước cấu hình chính xác của từng khách hàng.

Bạn không thấy Đại lý yêu thích của mình? Bạn có thể thử tự điều chỉnh nó bằng Hướng dẫn tích hợp chung — và chúng tôi muốn PR bổ sung thêm sự hỗ trợ gốc cho nó. Xem ĐÓNG GÓP.md để bắt đầu.

Bộ nhớ tác nhân TencentDB là gì?

Chúng tôi bắt đầu từ một câu hỏi thực tế: Làm cách nào để giảm bớt công việc lặp đi lặp lại khi sử dụng Đại lý?

Nếu bối cảnh dự án đã được giải thích thì không cần phải lặp lại trong phần mới. Nếu tài liệu đã được đọc, mọi Tác nhân không cần phải bắt đầu lại từ trang một. Một quy trình công việc đã hoạt động sẽ không cần phải được khám phá lại vào lần tiếp theo.

Trí nhớ ở đây không chỉ có nghĩa là “ghi nhớ những cuộc trò chuyện”. Bất kỳ thông tin nào giúp Tác nhân tiếp theo tránh phải phát minh lại bánh xe đều phải được lưu, sắp xếp và sử dụng lại.

Existing information → Reusable memory assets → Fewer turns → Less rework → More stable results and higher efficiency

Hãy để kinh nghiệm tích lũy, chảy và truyền lại cho Tác nhân tiếp theo

Trung tâm bộ nhớ dành cho các nhóm Đại lý sẽ khép lại toàn bộ vòng đời trải nghiệm: công việc tạo ra nội dung, nội dung được luân chuyển trong nhóm và các thành viên mới có thể tải tệp lưu của nhóm vào ngày đầu tiên.

1. Khai thác tài sản tự động: Trích xuất Bộ nhớ trò chuyện và Kỹ năng từ các cuộc hội thoại và nhiệm vụ; chuyển đổi tài liệu và mã thành Wiki và CodeGraph; sau đó quản lý, xem xét và định tuyến chúng một cách nhất quán.
2. Tương thích di động và đa tác nhân: Nội dung bộ nhớ được tách rời khỏi khung Tác nhân — chúng có thể di chuyển giữa các khung và được chia sẻ và duy trì bởi nhiều Tác nhân và thành viên nhóm.
3. Khởi động nguội thân thiện: Nhập các tài liệu, cơ sở mã và phiên trò chuyện của Đại lý hiện có. Nhóm Đại lý mới có thể bắt đầu từ kinh nghiệm hiện có thay vì học hỏi từ đầu.

🧠 Bộ não ghi nhớ con người và bối cảnh

• Bộ nhớ trò chuyện giữ lại các ưu tiên, sự kiện, quyết định và lịch sử tương tác.
• Mỗi Đặc vụ sẽ tự động có bộ nhớ riêng khi được tạo - không cần phải giới thiệu lại vào lần sau.
• Cuộc hội thoại L0 → Nguyên tử L1 → Kịch bản L2 → Persona L3 - các cuộc hội thoại thô được chắt lọc từng lớp.

"Đừng cấu trúc lại mô-đun xác thực cũ — thiết bị di động vẫn đang sử dụng nó." — Bối cảnh tốn kém này không nên phụ thuộc vào việc con người lặp lại nó mỗi lần.

⚡ Thư viện Skill tích lũy kiến thức chuyên môn

• Sau khi hoàn thành công việc phức tạp, Đại lý có thể trích xuất và quản lý các Kỹ năng có thể sử dụng lại từ các cuộc hội thoại và lệnh gọi công cụ, đồng thời nhập chúng vào ngữ cảnh của Đại lý được chỉ định khi cần.
• Kỹ năng không chỉ là một đoạn nhắc nhở; nó có các phiên bản, tệp tài nguyên, ranh giới kích hoạt, các bước thực hiện và quy tắc xác thực.
• Kỹ năng cá nhân theo mặc định là riêng tư; sau khi xem xét, chúng có thể được chia sẻ với nhóm và giao cho các Đại lý khác.

Khắc phục sự cố, đánh giá mã, danh sách kiểm tra phát hành — tìm hiểu một lần và cả nhóm có thể sử dụng nó.

📖 Bản đồ kiến thức đọc được cả tài liệu và code

• Wiki biến tài liệu sản phẩm, thông số thiết kế và sổ tay hoạt động thành các trang có cấu trúc với biểu đồ liên kết. (Lấy cảm hứng từ nền tảng kiến thức LLM của Karpathy.)

• CodeGraph lập chỉ mục các ký hiệu mã, tệp, mối quan hệ cuộc gọi và đường dẫn tác động.

  

• Đại lý có thể tìm kiếm, đọc, kiểm tra người gọi/người được gọi và thực hiện phân tích tác động trước khi sửa đổi mã.

Wiki ngăn cản Đại lý đọc mọi danh sách tệp trước khi bắt đầu làm việc. CodeGraph không chỉ cho họ biết "mã ở đây" — nó còn cho họ biết "việc thay đổi điều này có thể ảnh hưởng đến những điều đó".

🛡️ Bảng trí nhớ nhóm do con người điều khiển

• Tạo nhóm và Đại lý trong Memory Hub; xem xét, chia sẻ và trang bị tài sản bộ nhớ.
• Quản lý quyền sở hữu, phiên bản, trạng thái, khả năng hiển thị, số lượng sử dụng và ràng buộc Đại lý ở một nơi.
• private hoàn toàn thuộc về Chủ sở hữu; team được hiển thị cho tất cả các thành viên trong nhóm; restricted cấp quyền truy cập chính xác thông qua ACL của Người dùng / Vai trò / Đại lý.
• Hai lớp vai trò: Quản trị hệ thống toàn cầu quản lý người dùng và nhóm (tạo nhóm, thêm thành viên) và cũng có thể sử dụng Wiki, CodeGraph, Skill và các tính năng quản lý nội dung khác; Vai trò cấp nhóm bao gồm Quản trị viên (người quản lý nhóm) và Thành viên (thành viên thông thường), chịu trách nhiệm cộng tác tài sản và kiểm soát quyền truy cập trong nhóm. Quyền sở hữu tài sản được theo dõi thông qua Chủ sở hữu - Chủ sở hữu tự động có quyền quản lý tài sản của họ.

Khởi động nguội: Tải tệp lưu, sau đó bắt đầu làm việc

Nhiệm vụ đầu tiên của hầu hết các Đại lý là tìm hiểu lại dự án của bạn. Bộ nhớ tác nhân TencentDB biến chi phí học tập bạn đã trả thành một tệp lưu:

Cụ thể, những nội dung hiện có này có thể được nhập trực tiếp và xử lý tự động trong bảng điều khiển:

• Cơ sở mã: Nhập kho hiện có — CodeGraph tự động lập chỉ mục các ký hiệu, tệp, mối quan hệ cuộc gọi và đường dẫn tác động.
• Tài liệu & tập tin: Nhập tài liệu và tập tin có liên quan — Wiki tự động tạo các trang có cấu trúc với biểu đồ liên kết.
• Phiên trò chuyện: Nhập các phiên trò chuyện trước đây của Đại lý — Kỹ năng và trí nhớ trò chuyện được tự động trích xuất dưới dạng tài sản có thể sử dụng lại.

Hãy ngừng đào tạo lại mọi Đại lý. Cung cấp cho nó tập tin lưu.

Phong cách chơi một lần: Xây dựng nhóm đại lý đang phát triển cho công ty một người

Mở Memory Hub và tạo một nhóm:

Tiny but Serious Inc.
├── 👤 You · Set goals / Make decisions
├── 🔭 Scout · Research / Find opportunities
├── 🛠 Builder · Write code / Build products
├── 🧪 Reviewer · Test / Find issues
└── 🧠 Agent Memory · Preserve the team's experience

Bạn sẽ không mở bốn cửa sổ trò chuyện bị ngắt kết nối - bạn đang tập hợp một đội với các vai trò khác nhau có thể kế thừa kinh nghiệm tích lũy của nhóm.

Tuyển dụng trước, sau đó trang bị

🔭 Scout
   ├── User interview Chat Memory
   ├── Market research Wiki
   └── Competitive analysis Skill

🛠 Builder
   ├── Product Wiki
   ├── Project CodeGraph
   └── Feature Delivery Skill

🧪 Reviewer
   ├── Historical incident Chat Memory
   ├── Project CodeGraph
   └── Release Checklist Skill

Vai trò khác nhau, tải khác nhau. Ít tiếng ồn hơn - cung cấp cho mỗi Tác nhân nội dung bộ nhớ mà nó thực sự cần để hoàn thành công việc.

Công ty có thể rất nhỏ. Kinh nghiệm có thể tích lũy mãi mãi.

Tài sản bộ nhớ, không phải kho nhật ký trò chuyện

RAG trả lời "có thể tìm thấy gì?" Team Memory cũng trả lời "ai có thể sử dụng nó, phiên bản nào hợp lệ và Đại lý nào sẽ nhận được nó."

	Lịch sử trò chuyện	Tiêu chuẩn RAG	Bộ nhớ tác nhân TencentDB
Hiểu biết của người dùng giữa các phiên	△	△	✅ Bộ nhớ trò chuyện
Kinh nghiệm thực thi chắt lọc	—	—	✅ Kỹ năng
Cấu trúc và mối quan hệ của tài liệu	—	△ Truy xuất đoạn	✅ Wiki + Biểu đồ liên kết
Biểu đồ cuộc gọi mã và phạm vi tác động	—	△ So khớp văn bản	✅ Đồ thị mã
Quyền sở hữu / Phiên bản / Trạng thái	—	—	✅
Chia sẻ nhóm & Tải đại lý	—	—	✅
Riêng tư / Nhóm / ACL	—	△	✅

Hub bộ nhớ không phải là bảng hiển thị - Đó là bảng điều khiển

Phong cách chơi	Bạn làm gì trong Hub
Lập nhóm	Tạo nhóm, thêm người và Đại lý, xác định ranh giới chia sẻ
Thư viện nội dung	Duyệt, tìm kiếm, đánh giá và quản lý Bộ nhớ trò chuyện, Kỹ năng, Wiki và CodeGraph
Tải đại lý	Liên kết các tài sản bộ nhớ khác nhau với các Tác nhân khác nhau; điều chỉnh mức độ ưu tiên và chế độ sử dụng
Hội thảo kiến thức	Xây dựng Wiki và CodeGraph; theo dõi trạng thái xử lý và siêu dữ liệu nội dung
Kiểm soát truy cập	Chuyển đổi giữa quyền truy cập riêng tư, nhóm và dựa trên ACL; thu hồi chia sẻ khi cần thiết

Khi bạn mở một tài sản, điều quan trọng không chỉ là "nội dung đó nói gì" mà còn là "nó đến từ đâu, phiên bản nào, nó được gán cho ai và liệu nó có được sử dụng gần đây hay không".

Mỗi vòng lặp đều có được kinh nghiệm

Bộ nhớ không chạy vòng lặp Tác nhân; nó đảm bảo lần lặp tiếp theo kế thừa kết quả của lần lặp trước: các tương tác có giá trị vẫn được lưu trong Bộ nhớ trò chuyện, các quy trình công việc đã được chứng minh được chắt lọc thành Kỹ năng và các thay đổi về tài liệu/mã được cập nhật thông qua việc nhập Wiki và đồng bộ hóa CodeGraph.

Không có Bộ nhớ, các vòng lặp có thể lặp lại nhanh hơn. Với bộ nhớ được kế thừa, mỗi lần lặp lại có cơ hội tốt hơn lần lặp trước.

Một nhóm đại lý: Chia sẻ kinh nghiệm, không chia sẻ quyền riêng tư

Bộ nhớ trò chuyện và kỹ năng mới theo mặc định là riêng tư. Chia sẻ là một hành động rõ ràng, không phải là rò rỉ mặc định.

Khả năng hiển thị	Ngữ nghĩa
private	Chỉ Chủ sở hữu mới có thể đọc - thậm chí cả quản trị viên nhóm
team	Các thành viên trong nhóm có thể đọc; Chủ sở hữu / Quản trị viên có thể quản lý
restricted	Truy cập chính xác thông qua Người dùng / Vai trò / Đại lý ACL
agent	Để trang bị mục tiêu cho các Đại lý trong cùng một đội

Bạn có thể chỉ định "Kỹ năng phát hành" cho Tác nhân phát hành, "Wiki kiến trúc" cho tất cả các Tác nhân phát triển và CodeGraph cho Người viết mã và Người đánh giá.

Triển khai kỹ thuật

Bộ nhớ tác nhân TencentDB không nhằm mục đích "lưu trữ mọi thứ". Nó giải quyết ba vấn đề: những gì đáng giữ lại, ai có thể sử dụng nó và làm thế nào để lấy lại ít hơn trong khi lấy lại những thứ phù hợp vào lần sau.

1. Bộ nhớ không phải là bản ghi phẳng - nó phát triển theo từng lớp

Các cuộc hội thoại trước tiên được lưu dưới dạng L0, sau đó được tinh chỉnh bằng quy trình không đồng bộ thành nhiều cấp độ chi tiết:

Lớp	Những gì nó lưu trữ	Sử dụng chính
Hội thoại L0	Cuộc hội thoại thô với ngữ cảnh đầy đủ	Xác minh chính xác từ ngữ, dấu thời gian và nguồn
Nguyên tử L1	Sự kiện, sở thích, ràng buộc và sự kiện được trích xuất từ ​​các cuộc hội thoại	Thu hồi chính xác thông tin có thể hành động
Kịch bản L2	Các khối kiến thức được tổ chức xung quanh các dự án hoặc kịch bản	Nhanh chóng khôi phục bối cảnh làm việc
Lõi L3 / Persona	Hồ sơ dài hạn, mô hình ổn định và nhận thức cấp cao	Cho phép Đại lý nhanh chóng nhập bối cảnh của người dùng và nhóm

Cả việc tạo và truy xuất đều được phân lớp: thông thường, L2/L3 cung cấp khả năng khởi động ngữ cảnh nhanh chóng; khi cần thông tin cụ thể, BM25 + truy xuất vectơ + RRF sẽ quay trở lại L1/L0. Kết quả còn bị giới hạn bởi số lượng mục, ngân sách ký tự và giới hạn thời gian chờ để ngăn bộ nhớ tràn ngập cửa sổ ngữ cảnh.

2. Bộ nhớ không phải là lời nhắc chung — đó là phần tải của Tác nhân

Bộ nhớ trò chuyện, Kỹ năng, Wiki và CodeGraph đều được đăng ký thống nhất dưới dạng Tài sản bộ nhớ. Sử dụng Hub bộ nhớ Ràng buộc cố định + ACL để xác định nội dung nào mà Tác nhân nhất định có thể sử dụng: trước tiên hãy thu hẹp phạm vi quyền theo Nhóm, Người dùng, Tác nhân và mức độ hiển thị, sau đó truy xuất dựa trên truy vấn hiện tại.

Điều này cho phép các nhóm chia sẻ kinh nghiệm mà không tiết lộ tất cả thông tin cá nhân của họ; chuyển đổi Đại lý hoặc khung chỉ yêu cầu trang bị lại chứ không cần đào tạo lại.

3. Kiến thức không được cung cấp sỉ - nó được cung cấp theo yêu cầu

Các tài liệu được sắp xếp thành các trang Wiki có thể tìm kiếm được hỗ trợ việc xem chi tiết biểu đồ liên kết; cơ sở mã được lập chỉ mục thành nội dung CodeGraph chứa các tệp, ký hiệu và mối quan hệ cuộc gọi. Đại lý lần đầu tiên khám phá khả năng thông qua /v3/tools/list, sau đó sử dụng /v3/tools/call để đọc các trang, mã nguồn hoặc đường dẫn tác động có liên quan.

Điều này làm cho tài liệu và mã trở thành một phần của bộ nhớ — nhưng chúng vẫn là những công cụ có sẵn và chỉ đưa vào ngữ cảnh khi thực sự cần thiết.

Điểm chuẩn

Điểm chuẩn	Không có bộ nhớ tác nhân TencentDB	Khi nó được kích hoạt	Cải thiện tương đối
PersonaMem	48%	76%	+59%

PersonaMem kiểm tra xem Tác nhân có thể hiểu và áp dụng chính xác thông tin người dùng sau các tương tác kéo dài hay không.

Ghi chú

• Wiki và CodeGraph được xây dựng không đồng bộ; cho phép một chút thời gian xử lý trước khi chúng đạt được ready trạng thái.
• CodeGraph hiện ưu tiên các kho lưu trữ HTTPS công khai; hỗ trợ cho các kho lưu trữ riêng tư và thông tin xác thực SSH vẫn đang được cải tiến.
• Hub hỗ trợ ràng buộc tài sản thủ công; Định tuyến bộ nhớ hoàn toàn tự động vẫn đang được lặp lại.

Tài liệu liên quan

• Lộ trình (những gì chúng tôi đang xây dựng tiếp theo)
• Hướng dẫn cài đặt đầy đủ (Triển khai Memory Core + Hub + Proxy chỉ bằng một cú nhấp chuột)
• Lộ trình (những gì chúng tôi đang xây dựng tiếp theo; 中文: ROADMAP_CN.md)
• Công cụ di chuyển dữ liệu (v2 → v3) (nếu bạn đang sử dụng phiên bản cũ hơn và muốn di chuyển dữ liệu hiện có)
• API kiến thức mở
• Hướng dẫn đóng góp

Bộ nhớ tác nhân chưa có tiêu chuẩn ổn định. Tất cả các báo cáo lỗi, tài liệu, điểm chuẩn, bộ điều hợp khung mới và các trường hợp sử dụng Memory Hub sáng tạo hơn đều được hoan nghênh.

---

Lộ trình

Bản phát hành hiện tại là v2.0.0. Tiếp theo (v2.0.1): khởi động nguội không cấu hình, tạo Wiki nhanh hơn, lời nhắc tùy chỉnh của người dùng/nhóm, xuất kỹ năng và hỗ trợ Codex (chế độ IDE Plan).

👉 Xem toàn bộ kế hoạch tại ROADMAP.md (中文: ROADMAP_CN.md).

---

Lời cảm ơn

Bộ nhớ tác nhân TencentDB đứng trên vai cộng đồng nguồn mở:

• CodeGraph — mô-đun nội dung CodeGraph của chúng tôi sử dụng mã từ dự án này. Thiết kế biểu đồ mã được lập chỉ mục trước của nó là nền tảng cho việc triển khai của chúng tôi.
• Đại lý Hermes (Nous Research) - quản lý tài sản Kỹ năng của chúng tôi sử dụng một phần mã liên quan đến Kỹ năng từ Đặc vụ Hermes và dựa trên đó để xây dựng các tối ưu hóa tiếp theo.
• "LLM Wiki" của Andrej Karpathy — ý tưởng xử lý tài liệu như một tạo phẩm kiến thức ngày càng phát triển, được duy trì bằng LLM đã trực tiếp thông báo cách lớp Wiki của chúng tôi được xây dựng và cập nhật.

Chúng tôi rất biết ơn các tác giả và người đóng góp của các dự án này.

---

Cộng đồng & Đóng góp

Chúng tôi hoan nghênh tất cả các loại đóng góp - báo cáo lỗi, đề xuất tính năng, sửa lỗi tài liệu, sao chép điểm chuẩn, tích hợp hệ sinh thái hoặc yêu cầu kéo. Ký ức về tác nhân còn lâu mới ổn định và chúng tôi hy vọng có thể xây dựng nó cùng với cộng đồng.

• 🐞 Tìm thấy một lỗi hoặc có một câu hỏi? Mở một vấn đề trong GitHub vấn đề - chúng tôi trả lời trong vòng 24 giờ.
• 💡 Có một ý tưởng để chia sẻ? Bắt đầu một chủ đề trong GitHub Thảo luận.
• 🛠️ Bạn muốn đóng góp mã? Xin vui lòng đọc ĐÓNG GÓP.md đầu tiên.
• 💬 Bạn muốn trò chuyện với chúng tôi? Tham gia của chúng tôi Cộng đồng bất hòa và nói chuyện trực tiếp với các nhà phát triển cốt lõi.

---

Hãy để con đường mà cả đội đã đi trở thành vạch xuất phát của Đặc vụ tiếp theo.

---

✨ Người đóng góp

💡 Cảm ơn những người đóng góp sau đây đã cùng chúng tôi xây dựng - bạn làm cho Bộ nhớ tác nhân TencentDB trở nên tốt hơn.

Nếu Bộ nhớ tác nhân TencentDB hữu ích cho bạn, vui lòng cân nhắc việc gắn vai chính cho dự án. Nếu bạn có bất kỳ đề xuất nào, vui lòng mở một vấn đề để thảo luận.

---

Lịch sử ngôi sao

---

MIT © Nhóm bộ nhớ đại lý TencentDB