# 智能体

智能体是 AgentTeam 中真正执行工作的 AI 角色。

但在当前产品层面，更准确的理解不是“某台机器上挂了一个智能体”，而是三层关系一起工作：

- 角色：智能体长期承担的职责和协作边界
- 智能体：工作区里的协作角色
- 运行状态：这个智能体当前由哪台机器和运行环境承载

## 先理解四个关系

要正确使用智能体，最重要的是先理解下面四层关系：

- 工作区：协作边界和上下文归属地
- 角色：这个智能体长期负责什么、不负责什么
- 智能体：承担具体工作的执行角色
- 机器 / 运行环境：这个智能体当前在哪里运行、能不能执行

这也意味着智能体既不是一个纯云端对象，也不只是“某台机器里的一个本地进程”。它依赖角色定位、机器在线状态、本地运行环境，以及当前运行状态。

## 创建智能体时最重要的不是参数，而是定位

很多团队第一次创建智能体时，会把注意力都放在模型和配置项上。

但从长期使用效果看，更关键的是这四个问题：

- 这个智能体的职责是什么
- 它需要哪些可复用技能和长期记忆
- 它当前应该跑在哪台机器上
- 团队成员什么时候应该叫它

如果这些问题不清楚，智能体很容易变成“大家都能叫、但谁都不知道它到底该干什么”的噪音来源。

## 这一章包含什么

- [设计智能体阵容](./design-your-agent-team.md)
  适合团队负责人或管理员，解释怎么从 1 个智能体扩展到 3 到 5 个角色清晰的智能体。
- [角色、智能体和运行状态](./roles-agents-and-runtime.md)
  解释角色、智能体和运行状态分别解决什么问题。
- [配置智能体的角色、技能和记忆](./configure-agent-resources.md)
  帮你判断一个问题应该通过角色、技能还是记忆来解决。
- [使用角色](./use-agent-roles.md)
  说明如何把智能体的职责边界写清楚。
- [使用技能](./use-agent-skills.md)
  说明如何把反复出现的工作方法沉淀成稳定能力。
- [使用记忆](./use-agent-memory.md)
  说明哪些上下文值得保存，以及如何避免记忆变成噪音。
- [Agent Team](./agent-teams.md)
  解释如何把多个智能体组合成一个可 `@` 的团队入口，配置队长、成员职责和响应方式。
- [理解智能体记忆](./understand-agent-memory.md)
  解释哪些上下文值得被智能体长期参考。
- [日常管理智能体](./operate-agents.md)
  解释如何判断一个智能体是否健康、何时该调整、停用或清理。
- [多智能体协作实战](./multi-agent-dev-practice.md)
  通过一个开发案例展示如何让多个智能体分工协作。

## 高频建议

- 用职责命名智能体，不要用花哨人设命名
- 先少量上线，再逐步扩展
- 让每个智能体尽量拥有明确边界
- 把角色、智能体、运行状态分开理解，很多创建和排障问题会更好解释
- 出问题时先看机器和运行环境，再看提示词或命名
- 定期清理不再被使用的智能体

## 读完后建议继续看

- [创建你的第一个智能体](../quickstart/create-your-first-agent.md)
- [机器](../machines/README.md)
- [如何与智能体协作](../collaboration/working-with-agents.md)