Chuyển tới nội dung chính

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:

  1. 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)
  2. 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)
  3. Đồng bộ hóa cuộc trò chuyện với nhà cung cấp sau mỗi phản hồi
  4. Trích xuất bộ nhớ vào cuối phiên (dành cho các nhà cung cấp hỗ trợ nó)
  5. Ghi bộ nhớ tích hợp phản chiếu cho nhà cung cấp bên ngoài
  6. 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 choHệ 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ầupip install honcho-ai + API key hoặc phiên bản tự lưu trữ
Lưu trữ dữ liệuHoncho 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ìnhHướng dẫn tích hợp Honcho.

Tùy chọn cấu hình chính
Chìa khóaMặc địnhMô 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
aiPeerkhóa máy chủNhận dạng ngang hàng AI (một cho mỗi hồ sơ)
workspacekhóa máy chủID không gian làm việc chung
recallModehybridhybrid (tự động tiêm + công cụ), context (chỉ tiêm), tools (chỉ công cụ)
observationtất cả trênBoolean observeMe / observeOthers ngang hàng
writeFrequencyasyncasync , turn , session hoặc số nguyên N
sessionStrategyper-directoryper-directory , per-repo , per-session , global
dialecticReasoningLevellowminimal , low , medium , high , max
dialecticDynamictrueTự động xử lý theo độ dài truy vấn
messageMaxChars25000Số 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"
}
}
}

Di chuyển từ hermes honcho

Nế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ìnhHướ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 choQuả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ầupip install openviking + máy chủ đang chạy
Lưu trữ dữ liệuTự 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 choQuản lý bộ nhớ rảnh tay — Mem0 tự động xử lý việc trích xuất
Yêu cầupip 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óaMặc địnhMô tả
user_idhermes-userĐịnh danh người dùng
agent_idhermesĐị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 choThu 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óaMặc địnhMô tả
modecloudcloud hoặc local
bank_idhermesMã định danh ngân hàng bộ nhớ
budgetmidNhớ 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 choBộ 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ầuKhông có gì (SQLite luôn có sẵn). NumPy tùy chọn cho đại số HRR.
Lưu trữ dữ liệuSQLite 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óaMặc địnhMô tả
db_path$HERMES_HOME/memory_store.dbĐường dẫn cơ sở dữ liệu SQLite
auto_extractfalseTự động trích xuất thông tin vào cuối phiên
default_trust0.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 choCác nhóm đã sử dụng cơ sở hạ tầng của RetainDB
Yêu cầuTà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 choThu 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ầupip 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óaMặc địnhMô tả
container_taghermesThẻ 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_recalltrueChèn bối cảnh bộ nhớ có liên quan trước lượt
auto_capturetrueLưu trữ lượt trợ lý người dùng đã được làm sạch sau mỗi phản hồi
max_recall_results10Max nhớ lại các mục để định dạng theo ngữ cảnh
profile_frequency50Bao gồm thông tin hồ sơ ở lượt đầu tiên và mỗi N lượt
capture_modeallBỏ qua các lượt nhỏ hoặc tầm thường theo mặc định
search_modehybridChế độ tìm kiếm: hybrid , memories hoặc documents
api_timeout5.0Hế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} trong container_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_tags với danh sách custom_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ấpLưu trữChi phíCông cụPhụ thuộcTính năng độc đáo
Hoan hôĐám mâyĐã trả tiền4honcho-aiMô hình người dùng biện chứng
OpenVikingTự lưu trữMiễn phí5openviking + máy chủPhân cấp hệ thống tập tin + tải theo tầng
Mem0Đám mâyĐã trả tiền3mem0aiTrí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í3hindsight-clientSơ đồ tri thức + phản ánh tổng hợp
Hình ba chiềuĐịa phươngMiễn phí2Không cóĐại số HRR + chấm điểm tin cậy
Giữ lạiDBĐám mây$20/tháng5requestsNén Delta
ByteRoverĐịa phương/Đám mâyMiễn phí/Trả phí3brv CLITrích xuất nén trước
Siêu trí nhớĐám mâyĐã trả tiền4supermemoryHà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 .env củ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.