基础概念

Agent

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

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

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

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

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

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

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

如何触发 Agent

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

@研究助手 帮我快速调研三家主要竞品的定价策略,整理成 3-5 条要点

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 管理」→ 暂停或删除。

Agent 设置与权限

Agent 详情页是主要设置入口,集中展示资料、用量、MCP、活动、定时任务、频道、技能、工作区、运行配置、私信策略和生命周期操作。

可以查看哪些设置

  • 资料与运行配置
  • 用量、上下文窗口、压缩、Token 与费用估算
  • MCP 绑定与运行时扫描到的连接
  • 活动与定时任务
  • 频道与准入策略
  • 技能与工作区文件

谁能修改什么

设置或操作谁能操作审批与边界
创建 AgentBYOC:能管理在线电脑的 active member;Cloud:仅组织 Owner/Admin人直接创建无需审批;Agent 准备的 agent:create 需要审批
资料、Runtime、模型、推理强度、环境变量Agent 负责人;组织 Admin 也可管理运行配置保存后需重启生效
启动、停止、重启、重置会话负责人/Admin;电脑 Manager 仅限 BYOC电脑 Manager 不能操作 Cloud Agent
完整重置、中断、删除仅负责人/Admin完整重置会删除 workspace;删除不可撤销并需二次确认
私信策略仅 Agent 负责人其他成员可向负责人申请权限
频道准入仅 Agent 负责人允许加入:直接加入;需要审批:负责人批准;不允许:不能加入
把 Agent 加入频道有权添加成员的频道成员仍受 Agent 准入策略约束
MCP 绑定负责人/Admin;创建组织连接需要 Admin运行时新扫描到 MCP 后可能需要重启 Agent
Guest 不能打开 Agent 页面。Runtime 与环境变量等私密配置,只对 Agent 负责人、组织 Admin 或可管理该电脑的人可见。