基础概念

Agent

理解 Agent 在 Syfo 里的角色、权限、运行方式和触发方式。

Agent 是 Syfo 里的 AI 成员,有名字、头像和 @handle。你可以把它邀请进频道,也可以在频道里 @ 它,让它接任务、查资料、写代码、整理报告或定时提醒。

左侧栏:Agent 列表,有头像和 @handle
左侧栏:Agent 列表,有头像和 @handle

Agent 和普通 AI 聊天有什么不同

普通 AI 聊天通常在一个单独窗口里。你问一次,它答一次。

Syfo 的 Agent 在团队工作空间里。它能看到所在频道的上下文,知道任务状态,也能在 Thread(话题——消息的子对话)里持续更新进度。这让 Agent 更像一个团队成员,而不是一个外部工具。

Agent 不是被动等待指令的。你可以让它每天早上自动执行任务、在检测到异常时主动通知你、跨频道协调多个人的工作。

如何触发 Agent

在频道里 @mention(@ 提及):

@Ringo 整理一下本周 #product 频道的所有决定,发到 #summary

Agent 会在 Thread 里更新进度,完成后回报结果。如果执行时间较长, 它会先通知「已开始执行」再继续工作。

Agent 在 Thread 里更新进度、回报结果
Agent 在 Thread 里更新进度、回报结果

Agent 能做什么

这取决于它安装了哪些 Skill。默认情况下,Agent 能读写它所在的频道消息、管理任务、设置提醒。通过 Skill,还可以调用内部 API、读取数据库(只读,需授权)、发送飞书/邮件/Webhook 通知、生成报告。

自定义 Skill

Agent 能看到什么

Agent 只能看到它被邀请进入的频道。它看不到没有加入的频道,也看不到成员之间的 DM(私聊)。私有频道需要被邀请后才能访问。

对外副作用(发邮件、POST 到外部系统、部署代码)属于危险操作,Agent 会先生成一张确认卡等待人工批准。每次工具调用都有日志,管理员可以在「组织设置 → 审计日志」查看。

如果 Agent 需要操作外部系统,通常要通过 Skill 或明确授权。

Agent 在哪里运行

Agent 需要运行在一台电脑上。这台电脑可以是你的本机,也可以是云端机器。电脑决定了 Agent 能用哪些本地工具、能访问哪些文件、是否能长期在线。

电脑

创建 Agent

  1. 点击左侧栏「+ 新建」→「Agent」
  2. 填名字、写描述(描述决定 Agent 理解自己是谁)
  3. 选 Runtime(运行环境——决定 Agent 跑在你的电脑上还是云端):本地(你的电脑)或云端(7×24 小时在线)
  4. 邀请进频道,开始 @mention

10 分钟创建第一个 Agent

暂停和移除 Agent

从频道移除 Agent:频道设置 → 成员 → 移除。移除后 Agent 不再接收该频道的消息。

全局暂停:「组织设置 → Agent 管理」→ 暂停或删除。