---
order: 24
---

# 使用记忆

记忆用来保存之后还会影响协作的上下文。

它不是聊天记录归档，也不是越长越好的资料库。好的记忆应该让智能体少问重复问题，同时不会被过期信息误导。

> 记忆只保存之后还会影响判断的上下文。能在当前对话里解决的，不要急着保存。

## 什么值得进入记忆

判断一条信息是否值得保存，先看它以后还会不会被用到。

| 可以进入记忆 | 不建议进入记忆 |
| --- | --- |
| 长期项目目标、关键里程碑、重要约束 | 当前这次任务的一次性输入 |
| 稳定的用户或团队偏好 | 尚未确认的猜测 |
| 团队反复遵守的协作约定 | 很快会过期的临时安排 |
| 会影响后续判断的风险和决策 | 大段未整理的聊天内容 |

长期项目背景适合进入记忆。例如项目目标、关键里程碑、产品或技术约束、重要决策、已知风险。这些信息如果后续任务还会反复引用，就值得保存。

用户或团队偏好也适合进入记忆。例如输出希望先结论后细节，周报按项目分组，技术方案需要列风险和替代方案，客户沟通要避免某些表达。偏好必须稳定、明确，而且确实会反复使用。一次性的表达要求不需要保存。

团队约定同样适合进入记忆。例如需求评审必须列开放问题，发布前需要检查兼容性，线上问题分析要区分事实和推测，任务交接要写下一步和负责人。

持续任务状态也可以进入记忆，但这类信息最需要维护。状态变了，就要更新；任务结束了，就要清理。

## 什么时候不要用记忆

当前任务的一次性输入，不适合进入记忆。

尚未确认的猜测，不适合进入记忆。

很快会过期的临时安排，不适合进入记忆。

大段未整理的聊天内容，也不适合进入记忆。

记忆应该是筛选后的长期上下文，不是原始信息堆积。

## 记忆和聊天历史的区别

聊天历史记录发生过什么；记忆保存之后还要继续使用什么。

一段对话里可能只有一句话值得进入记忆。保存前最好把它整理成清楚、稳定、以后可复用的表达。

如果把所有聊天都塞进去，智能体不一定更聪明，反而更容易引用噪音。

## 记忆和角色、技能的区别

最简单的区分方式是：

- 角色决定智能体负责什么。
- 技能决定智能体怎么做。
- 记忆保存智能体之后需要参考什么。

| 内容 | 应该放到 |
| --- | --- |
| 你是发布协调员 | 角色 |
| 发布前按这 6 步检查 | 技能 |
| 这个项目每周三发布 | 记忆 |
| 当前风险是移动端兼容性 | 记忆，风险解除后要更新或删除 |

## 配置记忆前先想清楚

不是每个智能体都需要记忆。

长期跟进同一个项目的智能体，负责客户或团队协作的智能体，经常接续历史状态的智能体，以及 Agent Team 中承担协调职责的智能体，通常更需要记忆。

如果一个智能体只处理短平快的一次性任务，不配置记忆也可以。

配置记忆时，也要考虑权限和可见性。不要把不该共享的信息放进团队会复用的记忆里。

## 如何维护记忆

记忆不是写完就结束。维护不好，记忆会从资产变成噪音。

项目状态、决策、约定发生变化时，要及时更新。如果旧信息会误导智能体，不要只追加一条新说明，应该明确替换或删除旧内容。

完成的临时事项、不再有效的假设、过期偏好，都应该清理掉。记忆越简洁，智能体越容易用对。

同一件事不要用多个不同说法保存。如果记忆里出现冲突，智能体很难判断该相信哪一条。

| 维护动作 | 什么时候做 |
| --- | --- |
| 更新 | 项目状态、决策、约定发生变化 |
| 删除 | 信息过期，继续保留会误导智能体 |
| 合并 | 同一件事出现多个不同说法 |
| 暂不保存 | 还没确认，或只影响当前任务 |

## 怎么判断记忆有效

有效的记忆应该带来这些变化：

- 智能体能接上历史背景。
- 不需要反复补充基础信息。
- 能提醒之前的约定或未完成事项。
- 不会频繁引用过期信息。

如果智能体总是忘记背景，检查记忆是否没有配置、内容太散，或没有及时更新。

如果智能体经常引用过时内容，说明记忆需要清理。

## 常见问题

不要把所有聊天都塞进记忆。记忆应该是筛选后的长期上下文。

不要把流程说明写成记忆。流程和检查清单更适合放进技能。

不要把角色职责写成记忆。职责定位更适合放进角色。

不要让记忆无限增长。越重要、越长期、越稳定的信息，越适合留下。

## 继续阅读

- [使用角色](./use-agent-roles.md)
- [使用技能](./use-agent-skills.md)
- [配置智能体的角色、技能和记忆](./configure-agent-resources.md)