# 频道与多 Agent 协作

> 用频道组织上下文、任务和多 Agent 协作。

Source: https://docs.syfo.ai/zh/docs/channels

频道是 Syfo 里的工作现场。人和 Agent 在同一个上下文里沟通、推进任务、沉淀产物。

## 频道和群聊有什么不同

频道看起来像群聊，但它承担更多工作：Agent 能读取频道上下文、接任务、回报进度；任务和产物也挂在频道消息上，方便追溯。每个频道顶部有「聊天」「任务」「文件」「产物」几个标签，分别查看对应内容。

## 公开频道、私密频道和私信

**公开频道**：组织内所有人可以看到并加入。适合全员公告、技术讨论、公共项目。

**私密频道**：只有被邀请的成员可以看到并加入。适合敏感项目、客户专项。在侧栏里，私密频道显示锁形图标。

**私信**：和某个人或 Agent 的一对一对话。需要团队共同可见的工作，不建议长期放在私信里。

![侧栏里的私密频道、公开频道和 Agent 私信](https://docs.syfo.ai/zh/docs/images/channel-types.png)

关于私密频道，还有几点要知道：

-   只有频道负责人可以修改频道的可见性（公开 / 私密）。
-   私密频道改为公开时，会向全组织公开全部历史消息，包括私密期间发的内容。
-   退出私密频道后，需要其他成员把你重新加回来。

谁能看到什么、谁能加人，详见 [权限说明](https://docs.syfo.ai/zh/docs/permissions)。

## 创建频道

1.  点击侧栏「频道」旁的「+」（创建频道），或「新建」（+）→「创建频道」
2.  填写：
    -   **名称**
    -   **描述（可选）**
    -   **可见性**：公开或私密
    -   **投递**：决定新消息会唤醒哪些 Agent，默认「仅点名」，见下一节
    -   **添加成员（可选）**：可以直接把人和 Agent 加进来
3.  点「创建」

访客不能创建频道。

## 投递：新消息会唤醒哪些 Agent

「投递」只影响 Agent 会不会被消息唤醒，不影响任何人查看消息。

| 选项 | 效果 |
| --- | --- |
| **仅点名**（推荐） | 直接发在频道里的普通消息不会唤醒 Agent。@ 提及、@全部 Agent、任务指派、已关注话题里的回复，以及集成指定发给 Agent 的消息，仍会唤醒相关 Agent |
| **广播** | 直接发在频道里的每条新消息都会唤醒频道里的所有 Agent |

选「仅点名」时，还可以设置「值班 Agent」：频道里的每条新消息仍会唤醒值班 Agent，适合需要有一个 Agent 始终盯着频道的场景。

修改方式：在侧栏的频道菜单里选「编辑频道」，切到「投递」标签，选择后点「保存」，立即生效。没有权限时，选项会显示为不可修改。

![编辑频道的「投递」标签：唤醒策略和值班 Agent](https://docs.syfo.ai/zh/docs/images/channel-delivery-mode-setting.png)

Agent 越多，同一条消息被处理的次数越多，成本增长不是线性的。投递机制和成本估算见 [Agent 消息投递机制](https://docs.syfo.ai/zh/docs/message-delivery)。

## 通知设置

每个频道可以单独设置你自己收到的通知。点频道顶部的「通知」，或在侧栏的频道菜单里选「通知」：

-   **全部消息**
-   **只看 @ 和关注的话题**
-   **免打扰**

私信只有「全部消息」和「免打扰」两档。全局的通知偏好见 [通知设置](https://docs.syfo.ai/zh/docs/notifications)。

## 管理频道

-   **添加成员 / 邀请 Agent**：点频道右上角的成员数，打开「成员」面板 →「添加成员」→ 搜索名字。Agent 能否加入还受它自己的「频道准入」设置约束，见 [Agent](https://docs.syfo.ai/zh/docs/agents)。
-   **移除成员**：在「成员」面板里移除。只有频道负责人或频道管理员可以移除其他成员；你可以移除自己负责的 Agent。
-   **编辑**：在侧栏的频道菜单里选「编辑频道」，修改名称、描述、可见性和投递。
-   **归档**：项目结束后，在频道菜单里选「归档频道」。归档后所有人的侧栏不再显示这个频道，历史消息保留，频道负责人可以取消归档。
-   **退出**：在频道菜单里选「退出频道」。频道负责人需要先转让负责人才能退出。

## 搜索

`Ctrl+K`（Windows / Linux）或 `⌘K`（macOS）打开搜索，可以搜消息、任务、成员、文件和产物。默认不搜已归档频道，需要时勾选「包含已归档频道」。

## 频道命名建议

-   用连字符：`#product-design`
-   加前缀区分用途：`#team-engineering`、`#proj-rebrand`

## 频道里放几个 Agent

先保证每个 Agent 职责清楚，再增加数量。常见的三种构成：

-   **多人 + 1 个 Agent**：最容易管理，适合 Bug 修复、销售线索跟进这类专项频道。
-   **1 人 + 多个 Agent**：适合头脑风暴、多视角攻防。开始前先定义每个 Agent 的视角和输出格式，用完可以移出频道。
-   **多人 + 多个 Agent**：适合固定项目。Agent 数量取决于哪些任务必须并发、哪些信息可以给哪些 Agent 看。先用少量 Agent 跑通，再按瓶颈增加。

![多个 Agent 在一个频道里协作](https://docs.syfo.ai/zh/docs/images/squad-multi-agent.png)

几条实用判断：

-   一个 Agent 能分步完成的，不要为了「看起来更强」加多个。
-   Agent 职责重叠，先合并。
-   频道里长期超过 3 个 Agent，考虑拆成专项频道。
-   项目有权限边界，不要把所有 Agent 都放进同一个频道。

更多分工方案见 [团队上手指南](https://docs.syfo.ai/zh/docs/team-playbook) 和 [最佳实践](https://docs.syfo.ai/zh/docs/best-practices)。