Sparse Agent Memory
使用手册 · 无需登录

Sparse Agent Memory 使用手册

Sparse Agent Memory 帮助 Agent 保存工作偏好、项目约定和可复用的经验,供后续任务查询。你可以让已接入的 Agent 记下新信息,也可以在网页上查询、检查和备份自己的记忆。

第一次使用,建议先保存一条容易核对的偏好,再查询一次,确认它能在后续工作中用上。下面按实际使用顺序说明各个入口。

选择适合你的入口

你想做什么 从哪里开始
让 Sparse Agent 在任务中使用记忆 在 Sparse Agent 工作台打开设置 → 云端记忆。
查询和管理已保存的记忆 登录 Sparse Agent Memory,进入我的项目。
了解适合记住的内容与使用场景 阅读云端记忆使用说明与示例。

记忆按账号和项目管理。网页显示你自己的项目;在 Sparse 工作台中,每个 Agent 使用自己的记忆。使用同一个记忆服务,不代表所有 Agent 会自动共享全部内容。

连接 Sparse Agent 的云端记忆

  1. 登录 Sparse Agent 工作台,打开设置 → 云端记忆。
  2. 点击连接 Chat 账号,用当前工作台对应的 Auto-Coder Chat 账号完成授权,通常无需手动复制 API Key。
  3. 回到设置页,检查连接状态与记忆检索模型。首次使用可以保留自动:优先保留云端已有配置;尚无云端配置时,可以复用 Agent 模型。
  4. 在已有或新建 Agent 的后续任务中使用记忆。连接设置会在下一次任务激活时生效。

通过 Sparse 工作台完成记忆授权后,可以直接使用相应的云端记忆功能,无需另领记忆服务的邀请码。单独登录记忆服务网页时,仍按该网页的加入提示办理。

如果页面提示需要重新授权或模型配置未完成,先处理该提示,再让 Agent 保存或查询。也可以按需要选择复用 Agent 模型或保留云端独立模型,点击保存模型选择后检查结果。

保存一条偏好,再找回来

下面是给已经连接记忆工具的 Agent 的使用示例。先发出一条明确的记录要求:

请记住:以后给我写项目日报时,先说明完成了什么,再列出未完成事项和下一步。

随后在后续任务或会话中查询:

查一下我对项目日报的要求,然后按这个要求写今天的日报。

查看查询结果和最终报告,确认它确实使用了这条偏好。记忆是否被查询与更新,取决于 Agent 的接入方式和任务要求;明确说出要记什么、什么时候使用,会更容易核对。

适合保存的内容包括长期偏好、已经确认的项目决定、可复用的处理办法,以及需要避免的重复错误。短期信息应说明适用时间;密码和密钥使用专门的凭据管理方式。

在网页上查询记忆

打开 Sparse Agent Memory,点击使用 Auto-Coder Chat 登录。邀请制默认关闭,新用户验证 Chat 身份后即可自动注册并登录。管理员开启邀请制后,首次加入才需要选择首次使用?使用邀请码加入;已有成员继续直接登录。

  1. 在我的项目中选择要查看的项目,进入项目明细。
  2. 打开查询,在查询内容中输入问题,例如“项目日报有什么要求”。
  3. 第一次查询可以先保留默认的结果数量,分类留空;需要缩小范围时再填写分类。
  4. 点击查询,等待结果。若显示排队,按页面状态继续等待即可。

检查结果中的内容是否符合当前任务。没有找到时,先确认选中了正确的项目,再换一种说法查询。刚创建的空项目还没有可供查询的记忆,需要先由接入的 Agent 保存内容,或导入已有备份。

项目明细还可以查看最后更新时间等信息;点击刷新明细获取最新显示,点击返回列表选择其他项目。需要单独管理另一项工作时,可以在列表中填写新项目名并点击创建项目。创建项目后,仍需让使用记忆的 Agent 选择相应项目。

Team 共享记忆与审核

在导航中打开 Team,创建自己的团队或用 Owner 提供的链接申请加入。Owner 在 成员与申请 处理申请;成员加入后可以读取已通过的记忆并提交新内容、更新或删除申请。

默认每次写入都需要 Owner 审核,包括 Owner 自己的提交。记忆审核 会并排显示当前版本与提案;通过后才生效,驳回需要填写理由。提交者可以撤回待审稿。Owner 可在 Team 设置 关闭审核,使之后的提交直接生效;已有待审稿仍需逐项处理。

在 设置 → CLI / MCP 选择 Team · 名称 创建接入密钥,工具便可查询或提交该 Team 的记忆。工具返回“待审核”只代表提交成功。查询模型使用查询者自己的设置;个人项目不会自动加入 Team。

成员退出或被移除后,其 Team 密钥会撤销,待审稿会撤回;已通过的共享记忆保留。Owner 必须先转让所有权才能退出。

查询前需要哪些设置

如果查询提示缺少配置,打开设置 → 查询服务。已有可用配置时可以继续使用;尚未配置时,在模型设置选择页面提供的服务商,填写自己的 API Key 并保存。

已经使用 TypeSafe JEV 的用户,也可以在同页的 **JEV 设置(TypeSafe)**中保存自己的配置。页面会显示当前生效来源;已配置 JEV 时优先使用 JEV,否则使用已保存的模型。配置失效时,按提示修正后再查询。

查询设置用于帮助检索记忆。更换查询配置不会改写已经保存的记忆,导出、导入、状态查看和校验也不需要先配置查询模型。

更新约定,迁移已有记忆

情况变化后,把新要求和生效范围一起告诉已接入的 Agent。例如:“日报改为每周五发送,请更新此前的时间约定,从本周开始使用。”随后再查询一次,检查找到的是否为当前要求。

如果 Sparse Agent 已有本地记忆,在 Sparse 工作台的设置 → 云端记忆中选择迁移已有记忆,按 Agent 查看进度。迁移保留原有本地记录;它迁移的是已保存的记忆内容,聊天、浏览器资料和附件需要另行保存。

暂时停止云端访问时,在同一页面选择断开连接。已保存的云端记忆保留;重新使用前,再按页面提示连接。

检查状态,备份和恢复

在项目明细中,可以根据需要使用以下操作:

操作 怎样使用
状态 打开状态,点击加载状态,查看当前项目是否正常。
校验 打开校验,点击运行校验,检查保存的内容是否符合服务要求。校验不会修改记忆,也不判断内容在事实层面是否正确。
导出 打开导出,点击导出按钮,将返回的完整 JSON 保存为备份。
导入 先备份当前项目,再打开导入(整包替换),选择已有备份 JSON 文件或粘贴完整内容,核对目标项目后点击确认替换导入。

导入会替换目标项目当前的全部记忆内容。 备份中没有的旧内容不会保留。日常新增或修正一条记忆,适合交给已经接入的 Agent 完成;需要恢复备份时再使用导入。

恢复成功后,重新查看状态并查询一条熟悉的内容,确认恢复结果符合预期。备份包含你的记忆内容,应保存在自己选择的合适位置。

遇到问题时怎样继续

页面提示或情况 下一步
页面提示需要邀请码,或邀请码不可用 这表示管理员已开启邀请制;使用邀请人提供的有效邀请码。已有成员切回直接登录,并确认 Chat 账号正确。
会话失效或要求重新连接 网页重新登录;Sparse 的记忆连接则从设置 → 云端记忆重新授权。
查询提示缺少配置或配置无效 检查设置 → 查询服务;通过 Sparse 使用时,也检查工作台的记忆检索模型。
查询结果为空 确认账号、项目和保存结果,再换一种问题描述。
请求正在排队 等待状态更新。操作超时后,先回读结果再决定是否重试写入。
导入或校验失败 查看页面提示,确认选择的是完整备份。导入被拒绝时,原有内容保留。

完成第一次“保存 → 查询 → 应用”后,就可以把记忆用于更多日常工作。回到 Sparse Agent 使用手册,可以继续了解怎样设置目标、检查进展和安排后续任务。

Claude Code、Codex 与 WorkBuddy

通过 Auto-Coder Gateway 的 CLI、MCP 或 Skill 使用同一项目的记忆。打开 CLI / MCP 接入指南,按安装、创建项目密钥、连接客户端的顺序操作;登录后也可在「设置 → CLI / MCP」完成配置和撤销。

Markdown 原文: /skill.md