---
title: "智能体记忆"
description: "关于用户和项目的持久智能体记忆：remember 写入可读的笔记，recall 在预算内组装上下文，search 在写入前去重。"
---

# 智能体记忆

Notarium 中的智能体记忆并非隐藏的魔法，也不是一个独立的数据库：它就是 `agent-memory` 类的普通笔记，由智能体根据观察写入，你可以随时阅读、修正和删除。智能体通过 `remember_about_user` 和 `remember_about_project` 记录事实，通过 `recall` 取回上下文。关键的纪律是**先搜索再写入**，以免产生重复。

## 两条轴：关于用户与关于项目

记忆存在于两条正交的轴上：

- **关于用户**——`remember_about_user` 把关于你的长期事实（偏好、上下文、当前工作）写入你个人域的私有记忆。无论你在哪个空间工作，它都是同一份记忆——不会掺入到每个空间里。
- **关于项目**——`remember_about_project` 把关于某个具体项目的记忆写入它的子目录。与写入关于用户的记忆对称，但绑定到项目。

两条轴都使用 `agent-memory` 类。智能体**不选择**类、文件夹或空间：这一切都由工具本身强制执行。应当作为 `user-doc` 存在于项目树中的共享知识，由另一个工具 [`create_note`](/docs/agents/intent-tools/) 写入，而不是由「remember」写入。

## 每个类别一个文件，而非每条观察一个文件

`remember_about_user(observation, category)` 把观察**追加**到该类别的文件，而不是为每条事实生成一个微文件。`category` 是一个标签（「preferences」），不是路径。新类别意味着新文件。可选的 `summary` 是该类别的单行摘要，用于喂给派生的档案索引。

修正或删除某一条已记录的事实，就是编辑一篇普通笔记：用 `edit_note`，按记忆笔记的 id（由 `remember_*` 返回），以 `findReplace` 模式（空的 `content` 会移除该片段）或对整个类别用 `replace` 模式。没有单独的「按观察寻址」——记忆与任何笔记一样，用相同的基于词语的模式来编辑。

## recall ≠ search

两个工具都读取，但解决的问题不同：

| | `search` | `recall` |
|---|---|---|
| 返回什么 | 带 `score` 和 `path` 的排序片段 | 在 token 预算内的连贯上下文包 |
| 范围 | 相关笔记 | 相关笔记**外加**它们的图谱邻居（沿图谱 `depth` 跳） |
| 记忆 | 能看到记忆（用于去重） | 从知识和个人记忆中取用 |
| 何时调用 | 查找具体内容、写入前检查 | 围绕某个主题组装上下文以便工作 |

`recall` 更丰富：它围绕找到的内容遍历图谱，并把结果打包在 `budgetTokens` 之内，而 `maxPerSource` 则防止某一篇大笔记吃掉整个包。`search` 更精准：它正是「先搜索再写入」背后的机制。

## 先搜索再写入

记忆是唯一没有基于标题的重复保护的类，所以 `search` 刻意**也覆盖智能体的记忆**。永远先搜索再写入：这会同时对知识和记忆去重。

> [!tip] 去重的纪律
> 在 `remember_*` 之前，就该事实的主题调用 `search`。如果类别已经存在，就通过同一个 `remember_*`（它会追加）追加进去，或用 `edit_note` 修正，而不是创建一个同义项。

## 所有者能看到什么

记忆**在常规导航中是隐藏的**（树、文档流、普通搜索），但对你并不隐藏：它可以通过资源管理器树中专门的 **Memory** 透镜看到（笔记像其他任何笔记一样打开，地址为 `/m/<id>`），你可以在 **Agents → Context** 中静音某个类别。[修订日志](/docs/concepts/versioning/)中的条目会精确显示智能体记录了什么——这就是你捕捉注入可能夹带进来的任何东西的方式。你无法重新组织记忆：这一部分归智能体所有（一个扁平集合外加一个派生索引），但移动它在技术上是安全的——身份标识依托于笔记的 id。

## 下一步

- [上下文集合与固定项](/docs/agents/context-pins/)——如何静音某个记忆类别，以及启动时加载什么。
- [检索审计](/docs/agents/audit/)——智能体通过 `search`/`recall` 搜索了什么，以及是否找到了。
- [意图工具](/docs/agents/intent-tools/)——完整的工具集。