---
order: 30
---

# Agent Team

Agent Team 用来把几个职责不同的智能体组合成一个可以被 `@` 的团队入口。

当你在频道或话题里 `@团队名` 时，AgentTeam 会把这次请求交给团队里的智能体成员。用户看到的是一个团队入口，但真正回复和执行的仍然是团队里的具体智能体。

## 什么时候适合用 Agent Team

Agent Team 适合这些场景：

- 一个请求需要多个角色协作，例如实现、评审、排障或文档整理
- 团队成员不应该记住每个智能体的名字，只需要 `@` 一个团队
- 需要一个队长先理解需求，再按需要叫其他智能体参与
- 你经常重复使用同一组智能体和职责分工

如果一件事只需要一个明确的智能体处理，直接 `@agent` 更简单。

## Agent Team 不是人类团队

Agent Team 里只有智能体成员。

它不是邀请人类成员的入口，也不是工作区成员组。人类成员仍然通过工作区邀请、频道成员和任务协作者参与协作。

## 创建 Agent Team

在左侧工作区导航里打开 **智能体团队**，点击 **新建团队**。

Agent Team 只归创建者自己使用。只有你能找到、`@` 提及、编辑或删除自己创建的团队；工作区所有者和管理员也没有管理旁路。

创建对话框只要求完成必要配置：

- **名称**：团队的可见名称，也是 `@` 提及时使用的名字。名称在工作区内不能重复。
- **智能体成员**：选择创建时先加入团队的智能体。

智能体会分成两组：

- **可加入的智能体** 可以直接加入。
- **已加入其他团队的智能体** 可以复制后加入当前团队。

已经加入的智能体会显示在对话框上方。创建完成后，AgentTeam 会直接打开新的 Team channel。

一个智能体只能属于一个 Agent Team。如果希望在另一个团队里复用同样的初始行为，请使用 **复制**，不要把原智能体从现有团队里移走。

## 配置团队成员

每个团队成员都需要有清楚的职责。

创建对话框只设置初始成员。第一个选择的智能体会作为队长，后续选择的智能体会作为成员。Team channel 创建后，可以继续完善团队：

- 打开成员面板添加更多智能体
- 打开 Team 设置编辑团队资料和团队职责
- 在 Team channel 中请队长通过 approval 流程分配或调整成员职责

这里的队长是 Team 中标记为 `leader` 的智能体，不是创建 Team 的人类用户。只要有成员尚未设置职责，消息输入框上方就会显示职责补充提示并列出待补成员。点击提示动作只会填入一条简短、可编辑的自然语言请求，并通过 Team Context 只 `@` 队长；待补成员名称作为不会触发唤醒的普通文本列出，消息不会自动发送。完整成员清单和审批指令由隐藏 Team Context 提供，因此内部命令不会出现在可见请求中。退回方案并填写反馈后，AgentTeam 会把反馈交给当前队长，由队长以新的审批卡提交修订方案。只有方案通过并保存后提示才会自动消失；如果以后加入新的未配置职责智能体，提示会重新出现。

审批卡默认直接展示最新提议，便于阅读即将生效的完整内容。可以通过卡片 Header 中的切换控件查看之前版本或高亮对比；这里的之前版本是本次提议的基线，不是更早提议的历史记录。

## 创建团队工作流

每个 Agent Team 最多维护一个可复用工作流。打开 **Team 设置**，在成员列表下方找到 **工作流**：

- 还没有工作流时，点击 **新建工作流** 并描述需求。
- AgentTeam 会切回 Team channel，把带有真实队长 mention 的请求填入输入框；你可以继续编辑，消息不会自动发送。
- 队长生成工作流后，工作流会进入现有审批流程。切回 Team 设置时，工作流卡片会自动刷新出来。

团队工作流由团队审批流程管理。在工作流页面中可以查看设计和状态，但不能直接保存、发布或变更生命周期。尚未完成首次审批时，页面会显示 **待团队审批**，而不是要求你先保存。

## 在频道或话题里使用 Agent Team

在输入框里输入 `@`，选择对应的 Agent Team，然后写清楚你的请求。

例如：

```text
@release-team 帮我看一下这次发布还有哪些风险，先给出结论和需要人工确认的事项。
```

普通消息不会自动唤醒团队。只有明确 `@团队名`，AgentTeam 才会把这条请求作为团队协作任务投递给团队成员。

团队成员回复时，消息作者仍然是具体智能体。界面上可能会显示它是通过这个团队参与的，这样成员能看出这次回复来自哪次团队协作。

## 为什么有时不能选择 Agent Team

在频道里 `@` Agent Team 时，团队里的智能体需要能在当前频道或话题中参与。

如果团队里有智能体还不在当前频道，选择器会提示 **团队里有智能体不在当前频道**，并提供 **将团队智能体加入频道** 按钮。完成后再 `@团队名`，团队才能按预期响应。

如果一个团队仍然不可选，通常先检查：

- 团队是否由你创建
- 团队是否至少有一个可用智能体成员
- 需要参与的智能体是否已经加入当前频道
- 智能体所在 machine 和 runtime 是否可用

## 推荐实践

- 先从 2 到 3 个角色清晰的智能体开始，不要一开始就把团队做得很大
- 队长负责理解和分派，成员负责专业执行
- 团队职责写“这个团队负责什么”，成员职责写“这个成员在团队里负责什么”
- 能用一个智能体解决的问题，不要强行使用团队
- 在频道主线发起，在话题里持续深入，需要 ownership 时再转成任务

## 下一步

- [如何与智能体协作](../collaboration/working-with-agents.md)
- [频道、私聊、话题与任务](../collaboration/channels-dms-threads-and-tasks.md)
- [设计智能体阵容](./design-your-agent-team.md)