全部文档

智能体备忘

复制智能体方案时 不会 带上备忘。帮助智能体 没有 备忘。

来源 docs/core-mechanisms/智能体备忘.md

表述:备忘是用户主动写下、需要时再拿出来用的记录,不是跨会话自动想起的「记忆」。本文说明谁能用、怎么存、怎么查。

和记忆、任务的区别

| | 备忘 | 记忆 | 任务 | |--|----------|----------|--------------| | 用户说法 | 记下一条、按标签/日期再查 | 记住偏好、关于我、项目节点 | 待办、目标草稿 | | 何时进入对话 | 对话模式:仅当用户明确要查/存备忘(或按标签查已存记录)。备忘模式:没特别说明时,写入和读取都针对备忘 | 每轮自动注入索引与相关条目 | 对话时节选注入 | | 内容 | 文字 / 文件 / 图片;文件和图片会附带内容说明 | Markdown 条目 | TASKS.md 一篇草稿 | | 结构 | 标签 + 保存日期,相当于小型资料库 | 长期条目 / 日笔记 | 自由 Markdown |

复制智能体方案时 不会 带上备忘。帮助智能体 没有 备忘。

标签

类型用户说法行为
唯一例如员工姓名同一标签 + 同一键只有 一条。再记同一个人,合并进这条(也可要求覆盖)
可重复例如请假、支出每次保存都是 新的一条

用户可自建标签。保存时系统 自动写上保存日期(按账号时区的日历日)。

怎么用

  1. 消息 里对工作区智能体说:「把这段存进备忘」「记下员工张三…」「查请假」「查 2026年8月1日到8月14日的支出」。
  2. 也可在输入区把模式切到 备忘:之后若没特别说明(例如没说「写进记忆」),「记下 / 查找」都针对备忘。切到备忘后,对话左侧会出现备忘小窗(可拖动、拖边框改大小);关掉后留下的「备忘」按钮也可拖到别处,点一下或点输入区的备忘窗图标即可再打开,不必切换模式。助手改了备忘,小窗会马上更新。在小窗里 点选 一条或多条后,可直接在对话里说「改…」或「删掉」,不必先让助手再查一遍。每条右侧的阅读图标会打开较大窗口,方便阅读全文(Markdown 会排版)。
  3. 带文件或图片保存时,助手会先看懂内容,再写入说明。
  4. 在智能体详情 「备忘」 页可浏览、按标签/日期筛选、手动增删文字备忘、管理标签。

对话模式不会自动翻备忘:闲聊、问知识、问记忆、业务取数时,助手不去读备忘。备忘模式下则默认按备忘读写,仍可用「写进记忆」等明确说法改道。

实现对照

  • 表:agent_memo_tags / agent_memos / agent_memo_attachments(工作区分片)
  • 工具:memo_save(可带 id 改写点选的一条) / memo_search / memo_get / memo_delete / memo_list_tags
  • 对话请求:memo_modememo_ids(小窗点选,本轮注入后改/删)
  • REST:/api/v1/user-agents/{id}/memos/memo-tags
  • 代码:backend/internal/store/agent_memo.gobackend/internal/agenttool/memo.go