---
order: 20
---

# 角色、智能体和运行状态

很多团队第一次使用 AgentTeam 时，会把智能体理解成“某台机器上跑着的一个 AI”。

这个理解能解释一部分现象，但不够完整。真正影响日常协作的是三件事：这个智能体承担什么角色，团队在工作区里怎么叫它，以及它当前是否有可用的运行环境。

## 三层分别是什么

### 角色

角色定义的是智能体长期承担的职责。

它回答的问题是：这个智能体适合接什么任务，不适合接什么任务，输出应该对团队有什么帮助。一个角色可以用于多个场景，也可以随着团队使用逐步调整。

角色不直接参与聊天。团队成员平时 `@` 的不是角色本身，而是基于这个角色创建出来的智能体。

### 智能体

智能体是工作区里真正参与协作的对象。

它可以进入频道、私聊、话题和任务；团队成员使用 `@智能体` 时，叫起的就是这一层。

同一个角色可以用来创建多个智能体。比如同样是“发布协调员”，一个智能体可以负责产品发布，另一个可以负责内部工具发布。它们职责相似，但服务的工作场景不同。

### 运行状态

运行状态说明这个智能体当前是否能正常工作。

它和这些问题有关：

- 当前由哪台机器承载
- 运行环境是否准备好
- 模型和运行选项是否可用
- 当前是否在线、忙碌或异常

所以，机器更像是智能体的当前运行位置，不是智能体的全部身份。

## 创建智能体时怎么理解

在 AgentTeam Web 里创建智能体时，可以按这个顺序理解：

1. 先选择从空白开始，还是从模板或已有角色开始。
2. 再填写智能体名称、描述，并确认它在团队里负责什么。
3. 然后配置它需要的技能、记忆和协作范围。
4. 最后选择运行环境、模型和承载机器。

这四步分别解决不同问题：角色负责定位，智能体负责协作入口，技能和记忆负责工作质量，运行环境负责能不能实际执行。

## 哪些内容应该跟角色走

适合跟角色一起复用的内容，通常是长期稳定的东西：

- 角色名称和职责边界
- 适合处理的任务类型
- 重要的协作原则
- 常用技能
- 长期有效的团队约定或背景

不适合跟角色绑定的内容，通常是一次性的东西：

- 当前这次任务的临时输入
- 某次会话里的中间过程
- 已经过期的项目状态
- 只对某台机器有效的本地配置

如果一段信息只是为了当前任务服务，留在对话里即可。只有之后还会反复影响判断的内容，才值得整理进角色、技能或记忆。

## 常见误解

### 误解一：机器就是智能体本身

不是。

机器只说明当前由哪里承载运行。机器离线时，智能体可能暂时不可用，但这不等于它的角色和协作入口消失了。

### 误解二：一个角色只能创建一个智能体

不是。

一个稳定角色可以在不同场景里复用。关键是每个智能体在当前工作区里的分工要清楚，避免多个智能体抢同一类任务。

### 误解三：所有历史内容都会自动变成长期能力

不会。

聊天历史、临时文件和一次性输入不会自动变成可复用能力。真正值得长期复用的内容，需要整理成角色说明、技能或记忆。

## 继续阅读

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