---
name: index-gateway-memory
description: >
  Sparse Agent Memory 使用手册：连接云端记忆，让已接入的 Agent 保存和查询
  工作偏好与项目经验，在网页上管理项目、检查查询设置、导出备份和恢复记忆。
  Use when helping a user get started with Sparse Agent Memory or manage
  their memory through the workspace. This guide describes user operations.
---

# Sparse Agent Memory 使用手册

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

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

## 选择适合你的入口

| 你想做什么 | 从哪里开始 |
| --- | --- |
| 让 Sparse Agent 在任务中使用记忆 | 在 [Sparse Agent 工作台](https://sparse-agent.com/)打开**设置 → 云端记忆**。 |
| 查询和管理已保存的记忆 | 登录 [Sparse Agent Memory](https://memory.sparse-agent.com/)，进入**我的项目**。 |
| 了解适合记住的内容与使用场景 | 阅读[云端记忆使用说明与示例](https://sparse-agent.com/cases/agent-memory.html)。 |

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

## 连接 Sparse Agent 的云端记忆

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

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

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

## 保存一条偏好，再找回来

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

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

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

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

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

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

## 在网页上查询记忆

打开 [Sparse Agent Memory](https://memory.sparse-agent.com/)，点击**使用 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 使用手册](https://sparse-agent.com/cases/goal-kpi-constraints.html)，可以继续了解怎样设置目标、检查进展和安排后续任务。

## Claude Code、Codex 与 WorkBuddy

通过 Auto-Coder Gateway 的 CLI、MCP 或 Skill 使用同一项目的记忆。打开 [CLI / MCP 接入指南](https://memory.sparse-agent.com/docs/clients)，按安装、创建项目密钥、连接客户端的顺序操作；登录后也可在「设置 → CLI / MCP」完成配置和撤销。
