智能体备忘
复制智能体方案时 不会 带上备忘。帮助智能体 没有 备忘。
来源 docs/core-mechanisms/智能体备忘.md
表述:备忘是用户主动写下、需要时再拿出来用的记录,不是跨会话自动想起的「记忆」。本文说明谁能用、怎么存、怎么查。
和记忆、任务的区别
| | 备忘 | 记忆 | 任务 | |--|----------|----------|--------------| | 用户说法 | 记下一条、按标签/日期再查 | 记住偏好、关于我、项目节点 | 待办、目标草稿 | | 何时进入对话 | 对话模式:仅当用户明确要查/存备忘(或按标签查已存记录)。备忘模式:没特别说明时,写入和读取都针对备忘 | 每轮自动注入索引与相关条目 | 对话时节选注入 | | 内容 | 文字 / 文件 / 图片;文件和图片会附带内容说明 | Markdown 条目 | TASKS.md 一篇草稿 | | 结构 | 标签 + 保存日期,相当于小型资料库 | 长期条目 / 日笔记 | 自由 Markdown |
复制智能体方案时 不会 带上备忘。帮助智能体 没有 备忘。
标签
| 类型 | 用户说法 | 行为 |
|---|---|---|
| 唯一 | 例如员工姓名 | 同一标签 + 同一键只有 一条。再记同一个人,合并进这条(也可要求覆盖) |
| 可重复 | 例如请假、支出 | 每次保存都是 新的一条 |
用户可自建标签。保存时系统 自动写上保存日期(按账号时区的日历日)。
怎么用
- 在
消息里对工作区智能体说:「把这段存进备忘」「记下员工张三…」「查请假」「查 2026年8月1日到8月14日的支出」。 - 也可在输入区把模式切到 备忘:之后若没特别说明(例如没说「写进记忆」),「记下 / 查找」都针对备忘。切到备忘后,对话左侧会出现备忘小窗(可拖动、拖边框改大小);关掉后留下的「备忘」按钮也可拖到别处,点一下或点输入区的备忘窗图标即可再打开,不必切换模式。助手改了备忘,小窗会马上更新。在小窗里 点选 一条或多条后,可直接在对话里说「改…」或「删掉」,不必先让助手再查一遍。每条右侧的阅读图标会打开较大窗口,方便阅读全文(Markdown 会排版)。
- 带文件或图片保存时,助手会先看懂内容,再写入说明。
- 在智能体详情 「备忘」 页可浏览、按标签/日期筛选、手动增删文字备忘、管理标签。
对话模式不会自动翻备忘:闲聊、问知识、问记忆、业务取数时,助手不去读备忘。备忘模式下则默认按备忘读写,仍可用「写进记忆」等明确说法改道。
实现对照
- 表:
agent_memo_tags/agent_memos/agent_memo_attachments(工作区分片) - 工具:
memo_save(可带id改写点选的一条) /memo_search/memo_get/memo_delete/memo_list_tags - 对话请求:
memo_mode、memo_ids(小窗点选,本轮注入后改/删) - REST:
/api/v1/user-agents/{id}/memos、/memo-tags - 代码:
backend/internal/store/agent_memo.go、backend/internal/agenttool/memo.go