记忆系统
Hermes Agent 的持久化跨会话记忆系统,支持内置记忆文件和 8 种外部记忆提供商。
核心记忆文件
Hermes 使用三个核心 Markdown 文件来管理记忆:
SOUL.md — 代理身份
定义代理的人格、行为准则和核心身份。这是代理的"灵魂",决定了它如何与世界交互。
markdown
# SOUL.md 示例
## 身份
你是 Hermes,一个由 Nous Research 开发的 AI 助手。
## 性格特征
- 友好且专业
- 善于分析问题
- 乐于帮助用户
## 行为准则
- 始终使用中文回答
- 在不确定时主动提问确认
- 提供详细且准确的回答
MEMORY.md — 代理笔记
代理的跨会话工作笔记,最大 2200 个字符。代理可以自主读写此文件来记住重要信息。
容量限制:MEMORY.md 最大 2200 个字符。当超出限制时,代理会自动压缩或替换旧内容。建议保存最关键的信息。
USER.md — 用户档案
关于用户的持久化档案信息,最大 1375 个字符。包括用户的偏好、背景和需求。
markdown
# USER.md 示例
## 基本信息
- 名称:用户
- 语言:中文
- 时区:Asia/Shanghai
## 偏好
- 喜欢简洁的回答
- 偏好使用 Python
- 对 AI 安全感兴趣
## 背景
- 软件工程师
- 有 5 年开发经验
记忆管理命令
| 命令 | 说明 |
|---|---|
/memory read | 读取当前记忆内容 |
/memory write <text> | 写入新记忆 |
/memory append <text> | 追加记忆 |
/memory clear | 清除所有记忆 |
/memory search <query> | 搜索记忆内容 |
外部记忆提供商
除了内置文件记忆外,Hermes 还支持 8 种外部记忆服务提供商:
| 提供商 | 说明 |
|---|---|
| Honcho | 轻量级用户状态管理服务 |
| OpenViking | 开源知识图谱记忆系统 |
| Mem0 | AI 原生记忆层,智能记忆管理 |
| Hindsight | 基于向量数据库的记忆检索 |
| Holographic | 全息记忆系统,多维记忆存储 |
| RetainDB | 持久化对话记忆数据库 |
| ByteRover | 分布式记忆存储服务 |
| Supermemory | 云端个人知识库服务 |
配置外部记忆提供商
在 config.yaml 中配置外部记忆:
yaml
memory:
# 使用外部记忆提供商
provider: mem0
# Mem0 配置
mem0:
api_key: ${MEM0_API_KEY}
user_id: default-user
# 或者使用 Honcho
# provider: honcho
# honcho:
# api_key: ${HONCHO_API_KEY}
记忆工作原理
自动保存
代理在对话过程中自动识别重要信息并保存到记忆中。
智能检索
在每次对话开始时,自动检索相关记忆作为上下文。
跨会话持久
记忆在会话之间持久保存,关闭后重新打开仍然可用。
多层存储
内置文件记忆 + 可选外部提供商,灵活选择存储方案。
你可以直接告诉 Hermes 需要记住什么信息,例如"记住我喜欢用 Python 编程",代理会自动将其保存到记忆中。