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

`
``Bạn cũng có thể chọn nhà cung cấp bộ nhớ hoạt động thông qua
`Hermes plugins
` → Plugin nhà cung cấp → Nhà cung cấp bộ nhớ.

Hoặc cài đặt thủ công trong

~/.Hermes/config.yaml

:

`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 các ký ức 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 lý luận biện chứng, chèn ngữ cảnh trong phạm vi phiên, tìm kiếm ngữ nghĩa và kết luận liên tục. Ngữ cảnh cơ sở hiện bao gồm bản tóm tắt phiên cùng với phần trình bày của người dùng và thẻ ngang hàng, giúp tổng đài viên nhận thức được những gì đã được thảo luận.

| | |
|---|---|
| **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](https://app.Honcho.dev) 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ụ (5):**
`Honcho_profile
` (đọc/cập nhật thẻ ngang hàng),
`Honcho_search
` (tìm kiếm ngữ nghĩa),
`Honcho_context
` (ngữ cảnh phiên — tóm tắt, trình bày, thẻ, tin nhắn),
`Honcho_reasoning
` (tổng hợp LLM),
`Honcho_conclude
` (tạo/xóa kết luận)

**Kiến trúc:** Chèn ngữ cảnh hai lớp — một lớp cơ sở (tóm tắt phiên + trình bày + thẻ ngang hàng, được làm mới trên
`contextCadence

) cùng với phần bổ sung biện chứng (lý luận LLM, được làm mới trên
`dialecticCadence

). Phép biện chứng tự động chọn lời nhắc bắt đầu ban đầu (thông tin chung về người dùng) so với lời nhắc ấm áp (ngữ cảnh trong phạm vi phiên) dựa trên việc ngữ cảnh cơ sở có tồn tại hay không.

**Ba nút cấu hình trực giao** kiểm soát chi phí và độ sâu một cách độc lập:
-
`contextCadence

- tần suất làm mới lớp cơ sở (tần suất lệnh gọi API)
-
`dialecticCadence

- tần suất LLM biện chứng kích hoạt (tần số cuộc gọi LLM)
-
`dialecticDepth
` — có bao nhiêu

.chat()
` vượt qua mỗi lần gọi phép biện chứng (1–3, độ sâu của lý luận)

**Trình hướng dẫn cài đặt:**

`
``` bash
Hermes memory setup # select "Honcho" — runs the Honcho-specific post-setup

`
``Lệnh
`Hermes Honcho setup
` cũ vẫn hoạt động (hiện chuyển hướng đến
`Hermes memory setup

), nhưng chỉ được đăng ký sau khi Honcho được chọn làm nhà cung cấp bộ nhớ hoạt động.

**Cấu hình:**

$Hermes_HOME/Honcho.JSON
` (cục bộ) hoặc

~/.Honcho/config.JSON
` (toàn cầu). Thứ tự phân giải:

$Hermes_HOME/Honcho.JSON
` >

~/.Hermes/Honcho.JSON
` >

~/.Honcho/config.JSON

. Xem [config reference](https://GitHub.com/Hermes-ai/Hermes-agent/blob/main/plugins/memory/Honcho/README.md)[Honcho integration guide](https://docs.Honcho.dev/v3/guides/integrations/Hermes).`<details
<summaryTham khảo cấu hình đầy đủ</summary| Chìa khóa | Mặc định | Mô tả |
|------|----------|-------------|
|
`APIKey
` | -- | Khóa API từ [app.Honcho.dev](https://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 |
|
`contextTokens
` |
`null
` (chưa khai thác) | Ngân sách mã thông báo cho bối cảnh được chèn tự động mỗi lượt. Cắt ngắn ở ranh giới từ |
|
`contextCadence
` |
`1
` | Số lượt tối thiểu giữa các lệnh gọi API
`context()
` (làm mới lớp cơ sở) |
|
`dialecticCadence
` |
`2
` | Số lượt tối thiểu giữa các cuộc gọi
`peer.chat()
` LLM. Khuyến nghị 1–5. Chỉ áp dụng cho các chế độ
`hybrid

/
`context
` |
|
`dialecticDepth
` |
`1
` | Số lần vượt qua

.chat()
` cho mỗi lệnh gọi biện chứng. Đã kẹp 1–3. Đạt 0: nhắc nhở lạnh lùng/ấm áp, vượt qua 1: tự kiểm tra, vượt qua 2: hòa giải |
|
`dialecticDepthLevels
` |
`null
` | Mảng tùy chọn của các cấp độ lý luận cho mỗi lần vượt qua, ví dụ:

["minimal", "low", "medium"]

. Ghi đè mặc định theo tỷ lệ |
|
`dialecticReasoningLevel
` |

'low'
` | Cấp độ lý luận cơ bản:
`minimal

,
`low

,
`medium

,
`high

,
`max
` |
|
`dialecticDynamic
` |
`true
` | Khi
`true

, mô hình có thể ghi đè mức lý luận cho mỗi cuộc gọi thông qua thông số công cụ |
|
`dialecticMaxChars
` |
`600
` | Ký tự tối đa của kết quả biện chứng được đưa vào dấu nhắc hệ thống |
|
`recaLLMode
` |

'hybrid'
` |
`hybrid
` (tự động tiêm + công cụ),
`context
` (chỉ tiêm),
`tools
` (chỉ công cụ) |
|
`writeFrequency
` |

'async'
` | Thời điểm xóa tin nhắn:
`async
` (chuỗi nền),
`turn
` (đồng bộ hóa),
`session
` (lô ở cuối) hoặc số nguyên N |
|
`saveMessages
` |
`true
` | Có lưu giữ tin nhắn tới Honcho API hay không |
|
`observationMode
` |

'directional'
` |
`directional
` (bật tất cả) hoặc
`unified
` (nhóm dùng chung). Ghi đè bằng đối tượng
`observation
` |
|
`messageMaxChars
` |
`25000
` | Số ký tự tối đa cho mỗi tin nhắn (được chia nhỏ nếu vượt quá) |
|
`dialecticMaxInputChars
` |
`10000
` | Ký tự tối đa cho đầu vào truy vấn biện chứng vào
`peer.chat()
` |
|
`sessionStrategy
` |

'per-directory'
` |
`per-directory

,
`per-repo

,
`per-session

,
`global
` |`</details`<details
<summaryHoncho.JSON tối thiểu (đám mây)</summary

`JSON
{
"APIKey": "your-key-from-app.Honcho.dev",
"hosts": {
"Hermes": {
"enabled": true,
"aiPeer": "Hermes",
"peerName": "your-name",
"workspace": "Hermes"
}
}
}

`
``</details`<details
<summaryHoncho.JSON tối thiểu (tự lưu trữ)</summary

`JSON
{
"baseUrl": "http://localhost:8000",
"hosts": {
"Hermes": {
"enabled": true,
"aiPeer": "Hermes",
"peerName": "your-name",
"workspace": "Hermes"
}
}
}

`
``</details

:::tip[Migrating from XPROTECTX99XPROTECTX]
Nếu trước đây bạn đã sử dụng
`Hermes Honcho setup
` thì 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.

:::

**Thiết lập nhiều mạng:**

Honcho mô hình hóa các cuộc trò chuyện khi các đồng nghiệp trao đổi tin nhắn - một đồng nghiệp người dùng cộng với một đồng nghiệp AI trên mỗi hồ sơ Hermes, tất cả đều chia sẻ một không gian làm việc. Không gian làm việc là môi trường được chia sẻ: người dùng ngang hàng có tính toàn cầu trên các hồ sơ, mỗi người ngang hàng AI là một danh tính riêng. Mỗi AI ngang hàng đều xây dựng một biểu diễn/thẻ độc lập từ các quan sát của riêng mình, do đó, hồ sơ
`coder
` vẫn hướng theo mã trong khi hồ sơ
`writer
` vẫn được biên tập đối với cùng một người dùng.

Bản đồ:

| Khái niệm | Nó là gì |
|----------|----------|
| **Không gian làm việc** | Môi trường chia sẻ. Tất cả hồ sơ Hermes trong một không gian làm việc đều có cùng danh tính người dùng. |
| **Người dùng ngang hàng** (
`peerName

) | Con người. Được chia sẻ trên các hồ sơ trong không gian làm việc. |
| **AI ngang hàng** (
`aiPeer

) | Một cho mỗi hồ sơ Hermes. Khóa máy chủ
`Hermes
` → mặc định;
`Hermes.<profile
` cho người khác. |
| **Quan sát** | Per-peer chuyển đổi kiểm soát mô hình Honcho từ tin nhắn của ai.
`directional
` (mặc định, bật cả bốn) hoặc
`unified
` (nhóm người quan sát đơn). |

### Hồ sơ mới, đồng nghiệp Honcho mới

``` bash
Hermes profile create coder --clone

`

`--clone
` tạo khối máy chủ
`Hermes.coder
` trong
`Honcho.JSON
` với
`aiPeer: "coder"

,
`workspace
` được chia sẻ,
`peerName
` kế thừa,
`recaLLMode

,
`writeFrequency

,
`observation

, v.v. AI 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.

### Hồ sơ hiện có, chèn lấp các đồng nghiệp Honcho

`bash
Hermes Honcho sync

`
``Quét mọi hồ sơ Hermes, tạo khối máy chủ cho bất kỳ hồ sơ nào chưa có, kế thừa cài đặt từ khối
`Hermes
` mặc định và háo hức tạo các đồng nghiệp AI mới. Idempotent - bỏ qua các cấu hình đã có khối máy chủ.

### Quan sát theo hồ sơ

Mỗi khối máy chủ có thể ghi đè cấu hình quan sát một cách độc lập. Ví dụ: một hồ sơ tập trung vào mã trong đó AI ngang hàng quan sát người dùng nhưng không tự lập mô hình:

`JSON
"Hermes.coder": {
"aiPeer": "coder",
"observation": {
"user": { "observeMe": true, "observeOthers": true },
"ai": { "observeMe": false, "observeOthers": true }
}
}

`
``**Chuyển đổi quan sát (một bộ cho mỗi ngang hàng):**

| Chuyển đổi | Hiệu ứng |
|--------|--------|
|
`observeMe
` | Honcho xây dựng hình ảnh đại diện của thiết bị ngang hàng này từ các thông điệp của chính nó |
|
`observeOthers
` | Thiết bị ngang hàng này quan sát tin nhắn của thiết bị ngang hàng khác (cung cấp lý luận giữa các thiết bị ngang hàng) |

Các cài đặt trước qua
`observationMode

:
- **

"directional"

`
** (mặc định) — bật cả bốn cờ. Quan sát lẫn nhau đầy đủ; cho phép biện chứng ngang hàng.
- **

"unified"

** — người dùng
`observeMe: true

, AI
`observeOthers: true

, phần còn lại là sai. Nhóm người quan sát đơn lẻ; AI mô hình hóa người dùng chứ không phải chính nó, người dùng chỉ tự mô hình hóa người dùng.

Các nút bật tắt phía máy chủ được đặt thông qua [Honcho dashboard](https://app.Honcho.dev) sẽ vượt qua các giá trị mặc định cục bộ — được đồng bộ hóa trở lại vào lúc bắt đầu phiên.

Xem [Honcho page](./Honcho.md#observation-directional-vs-unified) để tham khảo quan sát đầy đủ.`<details
<summary Ví dụ đầy đủ về Honcho.JSON (đa cấu hình)</summary

``` json
{
"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,
"dialecticCadence": 2,
"dialecticDepth": 1,
"dialecticMaxChars": 600,
"contextCadence": 1,
"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"
}
}

`
``</details

Xem [config reference](https://GitHub.com/Hermes-ai/Hermes-agent/blob/main/plugins/memory/Honcho/README.md)[Honcho integration guide](https://docs.Honcho.dev/v3/guides/integrations/Hermes).

`
---

### 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 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:**

`
``` bash

# 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)
- Lược đồ URI
`viking://
` để 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** | Khóa API
`pip install mem0ai

+ |
| **Lưu trữ dữ liệu** | Đám mây Mem0 |
| **Chi phí** | Giá Mem0 |

**Công cụ:**
`mem0_profile
` (tất 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:**

`
``` bash
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àng

Bộ 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ự động giữ lại toàn bộ lượt hội thoại (bao gồm cả lệnh gọi công cụ) với tính năng theo dõi tài liệu ở cấp phiên.

| | |
|---|---|
| **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: Khóa API từ [ui.hindsight.vectorize.io](https://ui.hindsight.vectorize.io). Cục bộ: Khóa API LLM (OpenAI, Groq, OpenRouter, v.v.) |
| **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 trích xuất thực thể),
`hindsight_recall
` (tìm kiếm đa chiến lược),
`hindsight_reflect
` (tổng hợp bộ nhớ chéo)

**Cài đặt:**

`
``` bash
Hermes memory setup # select "hindsight"

# Or manually:
Hermes config set memory.provider hindsight
echo "HINDSIGHT_API_KEY=your-key" >> ~/.Hermes/.env

`
`Trình hướng dẫn thiết lập sẽ tự động cài đặt các phần phụ thuộc và chỉ cài đặt những gì cần thiết cho chế độ đã chọn (
`hindsight-CLIent
` cho đám mây,
`hindsight-all
` cho cục bộ). Yêu cầu
`hindsight-CLIent >= 0.4.22
` (tự động nâng cấp khi bắt đầu phiên nếu đã lỗi thời).

**Giao diện người dùng chế độ cục bộ:**
`hindsight-embed -p Hermes ui start
``**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ớ |
|
`recall_budget
` |
`mid
` | Thu hồi kỹ lưỡng:
`low
` /
`mid
` /
`high
` |
|
`memory_mode
` |
`hybrid
` |
`hybrid
` (ngữ cảnh + công cụ),
`context
` (chỉ tự động chèn),
`tools
` (chỉ công cụ) |
|
`auto_retain
` |
`true
` | Tự động giữ lại lượt hội thoại |
|
`auto_recall
` |
`true
` | Tự động gợi lại ký ức trước mỗi lượt |
|
`retain_async
` |
`true
` | Quá trình giữ lại không đồng bộ trên máy chủ |
|
`retain_context
` |
`conversation between Hermes Agent and the User
` | Nhãn ngữ cảnh cho những kỷ niệm được giữ lại |
|
`retain_tags
` || Thẻ mặc định được áp dụng cho những kỷ niệm được giữ lại; được hợp nhất với các thẻ công cụ cho mỗi cuộc gọi |
|
`retain_source
` || Tùy chọn
`metadata.source
` được gắn vào bộ nhớ được giữ lại |
|
`retain_user_prefix
` |
`User
` | Nhãn được sử dụng trước khi người dùng nộp bản ghi được lưu giữ tự động |
|
`retain_assistant_prefix
` |
`Assistant
` | Nhãn được sử dụng trước khi trợ lý nộp bản ghi được lưu giữ tự động |
|
`recall_tags
` || Thẻ để lọc khi thu hồi |

Xem [plugin README](https://GitHub.com/NousResearch/Hermes-agent/blob/main/plugins/memory/hindsight/README.md) để tham khảo cấu hình đầy đủ.

---

### Hình ba chiều

Kho lưu trữ thực tế SQLite cục bộ với 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:**

`
``` bash
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ố dành riêng cho 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:**

`
``` bash
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 [install script](https://byterover.dev)) |
| **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:**

`
``` bash

# 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 tri 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

+ [API key](https://supermemory.ai) |
| **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 tương tự 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:**

`
``` bash
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}
` trong
`container_tag
` (ví dụ:
`Hermes-\{identity}
`
`Hermes-coder

) để tách biệt 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.`<details
<summaryVí dụ về nhiều thùng chứa</summary

``` json
{
"container_tag": "Hermes",
"enable_custom_container_tags": true,
"custom_containers": ["project-alpha", "shared-knowledge"],
"custom_container_instructions": "Use project-alpha for coding context."
}

`
``</details`**Hỗ trợ:** [Discord](https://supermemory.link/Discord) · [support@supermemory.com](mailto: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 | 5 |

Honcho-ai
` | Mô hình hóa người dùng biện chứng + bối cảnh trong phạm vi phiên |
| **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 phân lập theo [profile](/docs/user-guide/profiles):
- **Nhà cung cấp bộ nhớ cục bộ** (Holographic, ByteRover) sử dụng đường dẫn

$Hermes_HOME/
` 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/
` để mỗi cấu hình 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 [Developer Guide: Memory Provider Plugins](/docs/developer-guide/memory-provider-plugin) để biết cách tạo của riêng bạn.