Nhà cung cấp bộ nhớ
Hermes Agent cung cấp 8 plugin nhà cung cấp bộ nhớ ngoài cung cấp cho tác nhân kiến thức liên tục, xuyên phiên ngoài MEMORY.md và USER.md tích hợp sẵn. Tại một thời điểm, chỉ một nhà cung cấp bên ngoài có thể hoạt động — bộ nhớ tích hợp luôn hoạt động cùng với nhà cung cấp đó.
Bắt đầu nhanh
hermes memory setup
# interactive picker + configuration
hermes memory status
# check what's active
hermes memory off
# disable external provider
Hoặc đặt thủ công trong ~/.hermes/config.yaml :
memory:
provider: openviking
# or honcho, mem0, hindsight, holographic, retaindb, byterover, supermemory
Nó hoạt động như thế nào
Khi nhà cung cấp bộ nhớ hoạt động, Hermes sẽ tự động:
- Chèn ngữ cảnh của nhà cung cấp vào dấu nhắc hệ thống (những gì nhà cung cấp biết)
- Tìm nạp trước những kỷ niệm liên quan trước mỗi lượt (nền, không chặn)
- Đồng bộ hóa cuộc trò chuyện với nhà cung cấp sau mỗi phản hồi
- Trích xuất bộ nhớ vào cuối phiên (dành cho các nhà cung cấp hỗ trợ nó)
- Ghi bộ nhớ tích hợp phản chiếu cho nhà cung cấp bên ngoài
- Thêm các công cụ dành riêng cho nhà cung cấp để nhân viên có thể tìm kiếm, lưu trữ và quản lý kỷ niệm
Bộ nhớ tích hợp (MEMORY.md / USER.md) tiếp tục hoạt động chính xác như trước. Nhà cung cấp bên ngoài là phụ gia.
Nhà cung cấp có sẵn
Honcho
Mô hình hóa người dùng phiên chéo phiên bản gốc AI với Hỏi đáp biện chứng, tìm kiếm ngữ nghĩa và kết luận liên tục.
| Tốt nhất cho | Hệ thống nhiều tác nhân với bối cảnh phiên chéo, liên kết tác nhân người dùng |
| Yêu cầu | pip install honcho-ai + API key hoặc phiên bản tự lưu trữ |
| Lưu trữ dữ liệu | Honcho Cloud hoặc tự lưu trữ |
| Chi phí | Giá Honcho (đám mây) / miễn phí (tự lưu trữ) |
Công cụ: honcho_profile (thẻ ngang hàng), honcho_search (tìm kiếm ngữ nghĩa), honcho_context (LLM tổng hợp), honcho_conclude (lưu trữ dữ kiện)
Trình hướng dẫn cài đặt:
hermes honcho setup
# (legacy command)
# or
hermes memory setup
# select "honcho"
Cấu hình: $HERMES_HOME/honcho.json (hồ sơ cục bộ) hoặc ~/.honcho/config.json (toàn cầu). Thứ tự giải quyết: $HERMES_HOME/honcho.json > ~/.hermes/honcho.json > ~/.honcho/config.json . Xem tham khảo cấu hình và Hướng dẫn tích hợp Honcho.
Tùy chọn cấu hình chính
| Chìa khóa | Mặc định | Mô tả |
|---|---|---|
apiKey | -- | Khóa API từ app.honcho.dev |
baseUrl | -- | URL cơ sở cho Honcho tự lưu trữ |
peerName | -- | Nhận dạng ngang hàng của người dùng |
aiPeer | khóa máy chủ | Nhận dạng ngang hàng AI (một cho mỗi hồ sơ) |
workspace | khóa máy chủ | ID không gian làm việc chung |
recallMode | hybrid | hybrid (tự động tiêm + công cụ), context (chỉ tiêm), tools (chỉ công cụ) |
observation | tất cả trên | Boolean observeMe / observeOthers ngang hàng |
writeFrequency | async | async , turn , session hoặc số nguyên N |
sessionStrategy | per-directory | per-directory , per-repo , per-session , global |
dialecticReasoningLevel | low | minimal , low , medium , high , max |
dialecticDynamic | true | Tự động xử lý theo độ dài truy vấn |
messageMaxChars | 25000 | Số ký tự tối đa cho mỗi tin nhắn (được chia nhỏ nếu vượt quá) |
Honcho.json (đám mây) tối thiểu
{
"apiKey": "your-key-from-app.honcho.dev",
"hosts": {
"hermes": {
"enabled": true,
"aiPeer": "hermes",
"peerName": "your-name",
"workspace": "hermes"
}
}
}
Honcho.json tối thiểu (tự lưu trữ)
{
"baseUrl": "http://localhost:8000",
"hosts": {
"hermes": {
"enabled": true,
"aiPeer": "hermes",
"peerName": "your-name",
"workspace": "hermes"
}
}
}
hermes honchoNếu trước đây bạn đã sử dụng hermes honcho setup , cấu hình của bạn và tất cả dữ liệu phía máy chủ vẫn nguyên vẹn. Chỉ cần kích hoạt lại thông qua trình hướng dẫn thiết lập hoặc đặt thủ công memory.provider: honcho để kích hoạt lại thông qua hệ thống mới.
Đa tác nhân / Hồ sơ:
Mỗi hồ sơ Hermes có thiết bị ngang hàng Honcho AI của riêng mình trong khi chia sẻ cùng một không gian làm việc -- tất cả hồ sơ đều có cùng một đại diện người dùng, nhưng mỗi tác nhân xây dựng danh tính và quan sát riêng của mình.
hermes profile create coder --clone
# creates honcho peer "coder", inherits config from default
Công việc --clone thực hiện: tạo khối máy chủ hermes.coder trong honcho.json với aiPeer: "coder" , được chia sẻ workspace , được kế thừa peerName , recallMode , writeFrequency , observation , v.v. Thiết bị ngang hàng được tạo ra một cách háo hức trong Honcho nên nó tồn tại trước tin nhắn đầu tiên.
Đối với hồ sơ được tạo trước khi Honcho được thiết lập:
hermes honcho sync
# scans all profiles, creates host blocks for any missing ones
Điều này kế thừa cài đặt từ khối máy chủ hermes mặc định và tạo các AI ngang hàng mới cho mỗi cấu hình. Idempotent -- bỏ qua các cấu hình đã có khối máy chủ.
Ví dụ đầy đủ về honcho.json (đa cấu hình)
{
"apiKey": "your-key",
"workspace": "hermes",
"peerName": "eri",
"hosts": {
"hermes": {
"enabled": true,
"aiPeer": "hermes",
"workspace": "hermes",
"peerName": "eri",
"recallMode": "hybrid",
"writeFrequency": "async",
"sessionStrategy": "per-directory",
"observation": {
"user": { "observeMe": true, "observeOthers": true },
"ai": { "observeMe": true, "observeOthers": true }
},
"dialecticReasoningLevel": "low",
"dialecticDynamic": true,
"dialecticMaxChars": 600,
"messageMaxChars": 25000,
"saveMessages": true
},
"hermes.coder": {
"enabled": true,
"aiPeer": "coder",
"workspace": "hermes",
"peerName": "eri",
"recallMode": "tools",
"observation": {
"user": { "observeMe": true, "observeOthers": false },
"ai": { "observeMe": true, "observeOthers": true }
}
},
"hermes.writer": {
"enabled": true,
"aiPeer": "writer",
"workspace": "hermes",
"peerName": "eri"
}
},
"sessions": {
"/home/user/myproject": "myproject-main"
}
}
Xem tham khảo cấu hình và Hướng dẫn tích hợp Honcho.
OpenViking
Cơ sở dữ liệu ngữ cảnh của Volcengine (ByteDance) với hệ thống phân cấp kiến thức kiểu hệ thống tệp, truy xuất theo cấp bậc và trích xuất bộ nhớ tự động thành 6 loại.
| Tốt nhất cho | Quản lý kiến thức tự lưu trữ với tính năng duyệt có cấu trúc |
| Yêu cầu | pip install openviking + máy chủ đang chạy |
| Lưu trữ dữ liệu | Tự lưu trữ (cục bộ hoặc đám mây) |
| Chi phí | Miễn phí (mã nguồn mở, AGPL-3.0) |
Công cụ: viking_search (tìm kiếm ngữ nghĩa), viking_read (xếp theo tầng: tóm tắt/tổng quan/đầy đủ), viking_browse (điều hướng hệ thống tệp), viking_remember (lưu trữ dữ kiện), viking_add_resource (nhập URL/tài liệu)
Cài đặt:
# Start the OpenViking server first
pip install openviking
openviking-server
# Then configure Hermes
hermes memory setup
# select "openviking"
# Or manually:
hermes config set memory.provider openviking
echo "OPENVIKING_ENDPOINT=http://localhost:1933" >> ~/.hermes/.env
Các tính năng chính:
- Tải ngữ cảnh theo từng cấp: L0 (~100 token) → L1 (~2k) → L2 (đầy đủ)
- Trích xuất bộ nhớ tự động trên cam kết phiên (hồ sơ, tùy chọn, thực thể, sự kiện, trường hợp, mẫu)
viking://Lược đồ URI để duyệt kiến thức theo cấp bậc
Mem0
Trích xuất thực tế LLM phía máy chủ với tìm kiếm ngữ nghĩa, sắp xếp lại và tự động loại bỏ trùng lặp.
| Tốt nhất cho | Quản lý bộ nhớ rảnh tay — Mem0 tự động xử lý việc trích xuất |
| Yêu cầu | pip install mem0ai + Khóa API |
| Lưu trữ dữ liệu | Đám mây Mem0 |
| Chi phí | Giá Mem0 |
Công cụ: mem0_profile (tất cả các bộ nhớ được lưu trữ), mem0_search (tìm kiếm ngữ nghĩa + sắp xếp lại), mem0_conclude (lưu trữ dữ kiện nguyên văn)
Cài đặt:
hermes memory setup
# select "mem0"
# Or manually:
hermes config set memory.provider mem0
echo "MEM0_API_KEY=your-key" >> ~/.hermes/.env
Cấu hình: $HERMES_HOME/mem0.json
| Chìa khóa | Mặc định | Mô tả |
|---|---|---|
user_id | hermes-user | Định danh người dùng |
agent_id | hermes | Định danh đại lý |
Nhận thức muộn màngBộ nhớ dài hạn với biểu đồ tri thức, độ phân giải thực thể và truy xuất đa chiến lược. Công cụ hindsight_reflect cung cấp khả năng tổng hợp nhiều bộ nhớ mà không nhà cung cấp nào khác cung cấp.
| Tốt nhất cho | Thu hồi dựa trên biểu đồ tri thức với các mối quan hệ thực thể |
| Yêu cầu | Đám mây: pip install hindsight-client + Khóa API. Cục bộ: pip install hindsight + khóa LLM |
| Lưu trữ dữ liệu | Đám mây Hindsight hoặc PostgreSQL nhúng cục bộ |
| Chi phí | Định giá nhận thức muộn (đám mây) hoặc miễn phí (cục bộ) |
Công cụ: hindsight_retain (lưu trữ với tính năng trích xuất thực thể), hindsight_recall (tìm kiếm đa chiến lược), hindsight_reflect (tổng hợp nhiều bộ nhớ)
Cài đặt:
hermes memory setup
# select "hindsight"
# Or manually:
hermes config set memory.provider hindsight
echo "HINDSIGHT_API_KEY=your-key" >> ~/.hermes/.env
Cấu hình: $HERMES_HOME/hindsight/config.json
| Chìa khóa | Mặc định | Mô tả |
|---|---|---|
mode | cloud | cloud hoặc local |
bank_id | hermes | Mã định danh ngân hàng bộ nhớ |
budget | mid | Nhớ lại kỹ lưỡng: low / mid / high |
Hình ba chiều
Kho lưu trữ thực tế SQLite cục bộ với tính năng tìm kiếm toàn văn bản FTS5, tính điểm tin cậy và HRR (Biểu diễn giảm ba chiều) cho các truy vấn đại số tổng hợp.
| Tốt nhất cho | Bộ nhớ chỉ cục bộ với khả năng truy xuất nâng cao, không phụ thuộc bên ngoài |
| Yêu cầu | Không có gì (SQLite luôn có sẵn). NumPy tùy chọn cho đại số HRR. |
| Lưu trữ dữ liệu | SQLite cục bộ |
| Chi phí | Miễn phí |
Công cụ: fact_store (9 hành động: thêm, tìm kiếm, thăm dò, liên quan, lý do, mâu thuẫn, cập nhật, xóa, liệt kê), fact_feedback (xếp hạng hữu ích/không hữu ích giúp rèn luyện điểm tin cậy)
Cài đặt:
hermes memory setup
# select "holographic"
# Or manually:
hermes config set memory.provider holographic
Cấu hình: config.yaml dưới plugins.hermes-memory-store
| Chìa khóa | Mặc định | Mô tả |
|---|---|---|
db_path | $HERMES_HOME/memory_store.db | Đường dẫn cơ sở dữ liệu SQLite |
auto_extract | false | Tự động trích xuất thông tin vào cuối phiên |
default_trust | 0.5 | Điểm tin cậy mặc định (0,0–1,0) |
Khả năng độc đáo:
probe— thu hồi đại số theo từng thực thể cụ thể (tất cả sự thật về một người/vật)reason— truy vấn AND tổng hợp trên nhiều thực thểcontradict— tự động phát hiện các sự kiện xung đột- Chấm điểm tin cậy với phản hồi không đối xứng (+0,05 hữu ích / -0,10 không hữu ích)
Giữ lạiDB
API bộ nhớ đám mây với tìm kiếm kết hợp (Vector + BM25 + Xếp hạng lại), 7 loại bộ nhớ và nén delta.
| Tốt nhất cho | Các nhóm đã sử dụng cơ sở hạ tầng của RetainDB |
| Yêu cầu | Tài khoản RetainDB + khóa API |
| Lưu trữ dữ liệu | Đám mây RetainDB |
| Chi phí | $20/tháng |
Công cụ: retaindb_profile (hồ sơ người dùng), retaindb_search (tìm kiếm ngữ nghĩa), retaindb_context (ngữ cảnh liên quan đến nhiệm vụ), retaindb_remember (lưu trữ với loại + tầm quan trọng), retaindb_forget (xóa bộ nhớ)
Cài đặt:
hermes memory setup
# select "retaindb"
# Or manually:
hermes config set memory.provider retaindb
echo "RETAINDB_API_KEY=your-key" >> ~/.hermes/.env
ByteRover
Bộ nhớ liên tục thông qua brv CLI — cây kiến thức phân cấp với khả năng truy xuất theo cấp độ (văn bản mờ → tìm kiếm theo hướng LLM). Ưu tiên cục bộ với đồng bộ hóa đám mây tùy chọn.| | |
|---|---|
| Tốt nhất cho | Các nhà phát triển muốn có bộ nhớ di động, cục bộ đầu tiên có CLI |
| Yêu cầu | ByteRover CLI ( npm install -g byterover-cli hoặc cài đặt tập lệnh) |
| Lưu trữ dữ liệu | Cục bộ (mặc định) hoặc ByteRover Cloud (đồng bộ hóa tùy chọn) |
| Chi phí | Định giá miễn phí (cục bộ) hoặc ByteRover (đám mây) |
Công cụ: brv_query (cây kiến thức tìm kiếm), brv_curate (lưu trữ dữ kiện/quyết định/mẫu), brv_status (phiên bản CLI + số liệu thống kê về cây)
Cài đặt:
# Install the CLI first
curl -fsSL https://byterover.dev/install.sh | sh
# Then configure Hermes
hermes memory setup
# select "byterover"
# Or manually:
hermes config set memory.provider byterover
Các tính năng chính:
- Tự động trích xuất nén trước (lưu thông tin chi tiết trước khi nén ngữ cảnh loại bỏ chúng)
- Cây kiến thức được lưu trữ tại
$HERMES_HOME/byterover/(theo phạm vi hồ sơ) - Đồng bộ hóa đám mây được chứng nhận SOC2 Loại II (tùy chọn)
Siêu bộ nhớ
Bộ nhớ dài hạn theo ngữ nghĩa với tính năng thu hồi hồ sơ, tìm kiếm ngữ nghĩa, công cụ bộ nhớ rõ ràng và nhập cuộc hội thoại cuối phiên thông qua API biểu đồ Supermemory.
| Tốt nhất cho | Thu hồi ngữ nghĩa với việc lập hồ sơ người dùng và xây dựng biểu đồ cấp phiên |
| Yêu cầu | pip install supermemory + Khóa API |
| Lưu trữ dữ liệu | Đám mây siêu nhớ |
| Chi phí | Giá siêu bộ nhớ |
Công cụ: supermemory_store (lưu ký ức rõ ràng), supermemory_search (tìm kiếm sự tương đồng về ngữ nghĩa), supermemory_forget (quên theo ID hoặc truy vấn phù hợp nhất), supermemory_profile (hồ sơ liên tục + ngữ cảnh gần đây)
Cài đặt:
hermes memory setup
# select "supermemory"
# Or manually:
hermes config set memory.provider supermemory
echo 'SUPERMEMORY_API_KEY=***' >> ~/.hermes/.env
Cấu hình: $HERMES_HOME/supermemory.json
| Chìa khóa | Mặc định | Mô tả |
|---|---|---|
container_tag | hermes | Thẻ vùng chứa được sử dụng để tìm kiếm và ghi. Hỗ trợ mẫu {identity} cho các thẻ có phạm vi hồ sơ. |
auto_recall | true | Chèn bối cảnh bộ nhớ có liên quan trước lượt |
auto_capture | true | Lưu trữ lượt trợ lý người dùng đã được làm sạch sau mỗi phản hồi |
max_recall_results | 10 | Max nhớ lại các mục để định dạng theo ngữ cảnh |
profile_frequency | 50 | Bao gồm thông tin hồ sơ ở lượt đầu tiên và mỗi N lượt |
capture_mode | all | Bỏ qua các lượt nhỏ hoặc tầm thường theo mặc định |
search_mode | hybrid | Chế độ tìm kiếm: hybrid , memories hoặc documents |
api_timeout | 5.0 | Hết thời gian chờ cho SDK và yêu cầu nhập |
Biến môi trường: SUPERMEMORY_API_KEY (bắt buộc), SUPERMEMORY_CONTAINER_TAG (ghi đè cấu hình).
Các tính năng chính:
- Tự động rào cản bối cảnh - loại bỏ các ký ức được nhớ lại từ các lượt đã ghi để ngăn ngừa ô nhiễm bộ nhớ đệ quy
- Nội dung hội thoại cuối phiên để xây dựng kiến thức ở cấp biểu đồ phong phú hơn
- Thông tin hồ sơ được đưa vào lượt đầu tiên và theo các khoảng thời gian có thể định cấu hình
- Lọc tin nhắn tầm thường (bỏ qua "ok", "cảm ơn", v.v.)
- Vùng chứa trong phạm vi hồ sơ — sử dụng
{identity}trongcontainer_tag(ví dụ:hermes-{identity}→hermes-coder) để tách biệt các bộ nhớ trên mỗi hồ sơ Hermes - Chế độ nhiều vùng chứa — bật
enable_custom_container_tagsvới danh sáchcustom_containersđể cho phép tác nhân đọc/ghi trên các vùng chứa được đặt tên. Các hoạt động tự động (đồng bộ hóa, tìm nạp trước) vẫn ở trên vùng chứa chính.
Ví dụ về nhiều vùng chứa
{
"container_tag": "hermes",
"enable_custom_container_tags": true,
"custom_containers": ["project-alpha", "shared-knowledge"],
"custom_container_instructions": "Use project-alpha for coding context."
}
Hỗ trợ: Discord · support@supermemory.com
So sánh nhà cung cấp
| Nhà cung cấp | Lưu trữ | Chi phí | Công cụ | Phụ thuộc | Tính năng độc đáo |
|---|---|---|---|---|---|
| Hoan hô | Đám mây | Đã trả tiền | 4 | honcho-ai | Mô hình người dùng biện chứng |
| OpenViking | Tự lưu trữ | Miễn phí | 5 | openviking + máy chủ | Phân cấp hệ thống tập tin + tải theo tầng |
| Mem0 | Đám mây | Đã trả tiền | 3 | mem0ai | Trích xuất LLM phía máy chủ |
| Nhận thức muộn màng | Đám mây/Cục bộ | Miễn phí/Trả phí | 3 | hindsight-client | Sơ đồ tri thức + phản ánh tổng hợp |
| Hình ba chiều | Địa phương | Miễn phí | 2 | Không có | Đại số HRR + chấm điểm tin cậy |
| Giữ lạiDB | Đám mây | $20/tháng | 5 | requests | Nén Delta |
| ByteRover | Địa phương/Đám mây | Miễn phí/Trả phí | 3 | brv CLI | Trích xuất nén trước |
| Siêu trí nhớ | Đám mây | Đã trả tiền | 4 | supermemory | Hàng rào bối cảnh + nhập biểu đồ phiên + nhiều vùng chứa |
Cách ly hồ sơ
Dữ liệu của mỗi nhà cung cấp được tách biệt theo profile:
- Nhà cung cấp bộ nhớ cục bộ (Holographic, ByteRover) sử dụng
$HERMES_HOME/đường dẫn khác nhau cho mỗi cấu hình - Nhà cung cấp tệp cấu hình (Honcho, Mem0, Hindsight, Supermemory) lưu trữ cấu hình trong
$HERMES_HOME/nên mỗi hồ sơ đều có thông tin xác thực riêng - Nhà cung cấp đám mây (RetainDB) tự động lấy tên dự án trong phạm vi hồ sơ
- Nhà cung cấp Env var (OpenViking) được định cấu hình qua tệp
.envcủa mỗi cấu hình
Xây dựng nhà cung cấp bộ nhớ
Xem Hướng dẫn dành cho nhà phát triển: Plugin nhà cung cấp bộ nhớ để biết cách tạo plugin của riêng bạn.