---
order: 21
---

# 配置智能体的角色、技能和记忆

一个智能体要长期好用，关键不只是模型和运行环境，还在于它的配置是否放对位置。

在 AgentTeam 里，角色、技能和记忆分别管三件事：角色管“它负责什么”，技能管“它怎么做”，记忆管“它之后还要记住什么”。这三件事看起来相近，但混在一起之后，智能体很快就会变得难维护：角色越写越长，技能里夹着项目背景，记忆里又堆满一次性对话。

更好的做法是，先判断你到底要解决哪类问题。

> 先问一句：这个问题是在“分工不清”、“做法不稳”，还是“背景记不住”？对应的答案就是角色、技能和记忆。

## 先判断要改什么

| 你看到的现象 | 优先调整 |
| --- | --- |
| 团队不知道什么时候该叫这个智能体 | 角色 |
| 智能体什么都想管，和其他智能体抢职责 | 角色 |
| 任务目标清楚，但每次做法都不稳定 | 技能 |
| 同一套步骤每次都要重新解释 | 技能 |
| 总是忘记项目、客户或团队背景 | 记忆 |
| 一段背景下周、下个月还会影响判断 | 记忆 |

只对当前这次任务有用的内容，留在对话里就够了。不要为了“以后可能有用”把所有东西都保存下来。

## 新建智能体时的顺序

新建智能体时，建议先把角色写清楚。

角色不需要很长，但必须能回答两个问题：它负责什么，以及它不负责什么。角色清楚之后，再给它配置最常用的技能。等它开始参与真实工作，再把稳定、会反复用到的背景放进记忆。

```text
先定角色
  它负责什么，不负责什么

再配技能
  它需要稳定处理哪些高频任务

最后补记忆
  它之后需要持续参考哪些背景
```

不要一开始就追求配置完整。很多团队会在第一天把职责、流程、项目背景、团队偏好全部写进去，结果后面很难判断哪一段真正影响了智能体表现。先让它跑起来，再根据真实使用补配置，通常更稳。

## 优化现有智能体时的顺序

如果一个智能体“不好用”，先不要直接重写所有说明。

可以先看具体症状：

- 它经常接不该接的活，说明角色边界太宽。
- 它每次输出结构都不一样，说明技能不够清楚。
- 它总要别人重复项目背景，说明记忆没有维护好。
- 它有技能但不用，可能是技能太抽象，或者和角色不匹配。
- 它引用了过期信息，说明记忆需要清理。

一次只改一类配置，更容易看出效果。全部一起改，短期看似变好了，长期很难知道真正起作用的是哪一部分。

## Agent Team 里怎么用

Agent Team 里，角色分工要先于技能和记忆。

先让每个成员有清楚的位置：谁负责拆解，谁负责实现，谁负责评审，谁负责收口。分工清楚之后，再给对应成员配置技能。例如评审成员需要评审技能，测试成员需要测试计划技能，协调成员需要任务拆解和风险跟踪技能。

| 团队成员 | 角色重点 | 常见技能 | 通常是否需要记忆 |
| --- | --- | --- | --- |
| 协调者 | 拆任务、追风险、收口结论 | 任务拆解、风险跟踪 | 经常需要 |
| 执行者 | 完成某类具体任务 | 对应任务的操作步骤 | 看任务是否长期 |
| 评审者 | 找问题、给判断、提阻塞点 | 评审清单、测试计划 | 通常不需要很多 |
| 记录者 | 整理进展和决策 | 纪要、周报、知识整理 | 经常需要 |

记忆更适合给长期跟进项目、客户或团队约定的成员使用。不是每个成员都需要同一份记忆，也不要把所有背景都塞给所有智能体。

## 最常见的放错位置

| 放错方式 | 会带来的问题 | 更适合放到 |
| --- | --- | --- |
| 项目背景写进角色 | 角色越来越臃肿，后续不好复用 | 记忆 |
| 操作流程写进记忆 | 智能体知道背景，但不一定按稳定步骤执行 | 技能 |
| 职责边界写进技能 | 智能体学会做法，但仍然不知道该不该接任务 | 角色 |
| 所有聊天都保存成记忆 | 重要信息被噪音淹没 | 对话，或筛选后再进记忆 |

如果只记一个原则：角色要短而清楚，技能要具体可执行，记忆要经过筛选和维护。

## 继续阅读

- [使用角色](./use-agent-roles.md)
- [使用技能](./use-agent-skills.md)
- [使用记忆](./use-agent-memory.md)