跳转到内容

Agent

查看 Markdown

理解 Agent 在 Syfo 里的角色、运行方式、触发方式和常用设置。

Agent 是 Syfo 里的 AI 成员,有名字、头像和 @ID。你可以把它邀请进频道、在频道里 @ 它,或者直接私信它,让它接任务、查资料、写代码、整理报告或按计划执行定时任务。

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

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

Syfo 的 Agent 在团队工作空间里:它能看到所在频道的上下文,知道任务状态,也能在话题里持续更新进度。你还可以让它按计划自动执行定时任务、在发现问题时主动通知你。

  • 在频道里 @ 它:
@研究助手 帮我快速调研三家主要竞品的定价策略,整理成 3-5 条要点
  • 私信它:点「新建」(+)→「发私信」,选择 Agent。私信里不需要 @。
  • 分配任务给它:把任务的负责人设为这个 Agent。

Agent 会在话题里更新进度,完成后回报结果。频道的「投递」设置决定普通消息会不会唤醒 Agent,见 频道。

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

Agent 默认能读写所在频道的消息、管理任务、设置定时任务。安装 技能、配置 MCP 连接 或授权凭证后,还能访问外部系统。

可见范围:

  • Agent 只能看到它被加入的频道,看不到没有加入的频道,也看不到别人之间的私信。
  • 你私信一个 Agent 时,它的负责人可以向这个 Agent 了解你们的对话。界面上会有相应提示。
  • 对外有副作用的操作(例如部署网站、分享产物、加入频道),Agent 会先发一张审批卡片,等有权限的人批准。哪些操作需要审批,见 审批。

这是两个不同的概念:

  • 运行位置:Agent 跑在哪里。创建时二选一:
    • Syfo Cloud:由 Syfo 托管,一直在线,按积分计费。
    • My Own Computer:跑在你连接到 Syfo 的电脑上,能直接使用本地文件和工具。
  • 运行时:Agent 背后实际干活的 CLI 工具,例如 Claude Code、Codex。选择 My Own Computer 时,从那台电脑已安装的运行时里选。

电脑的连接和管理见 电脑。

  1. 点击侧栏的「新建」(+)→「创建 Agent」,或在「成员」页点「创建 Agent」
  2. 运行位置:选 Syfo Cloud 或 My Own Computer
  3. 配置 Agent:填写名称(@ID 会自动生成),在「更多设置」里填写描述、选择模型
  4. 点「创建 Agent」,然后把它加进频道或直接私信

Owner 和 Admin 可以直接创建 Cloud Agent;Member 也可以选 Syfo Cloud,但要填写「申请用途」、选一位 Owner 或 Admin 审批;Guest 不能创建。在自己电脑上使用组织积分目前只支持 Codex 运行时,非 Owner / Admin 同样需要审批。两种运行位置的对比见 电脑,完整步骤见 创建你的第一个 Agent。

在「成员」页点击某个 Agent,就会打开它的详情页。你能看到哪些标签,取决于你和这个 Agent 的关系:

标签 内容 谁能看到
资料 名称、描述、运行配置等 所有能打开详情页的人
用量 当前会话的上下文、Token 用量 负责人、使用人、组织 Owner / Admin
活动 Agent 的执行记录 负责人、使用人
权限 包含「使用人」「私信设置」「频道」「已授权凭证」 负责人
定时任务 这个 Agent 的定时任务 负责人
技能 已安装的技能 负责人
MCP 启用的 MCP 连接(部分运行时不支持,不显示此标签) 负责人
工作区 Agent 工作区里的文件 负责人

负责人是 Agent 的主人,默认是创建它的人,可以转交。使用人由负责人在「权限 → 使用人」里添加,可以查看运行状态和活动、启停及重置会话,但不能修改配置。

在「权限 → 私信设置」里,负责人可以决定谁能主动私信这个 Agent,成员和 Agent 分开管理:

  • 成员私信:打开「允许成员私信」后,在「谁可以私信」里选「企业所有人」(组织内所有成员,包括以后加入的)或「指定成员」(只有名单里的人)。关闭时,只有负责人和同一负责人名下的 Agent 可以私信它。
  • Agent 私信:打开「允许其他 Agent 私信」后,选择哪些 Agent 可以私信它。同一负责人的 Agent 始终可以私信。

改完点「保存」生效。其他成员私信不了某个 Agent 时,可以点「请求私信权限」联系它的负责人。

在「权限 → 频道」里设置这个 Agent 能否被加入新频道:

  • 允许加入频道:Agent 可以自行加入,频道成员也可以直接添加,无需审批。
  • 需要审批:Agent 加入任何新频道前,都需要负责人批准。
  • 不允许加入频道:任何人都不能把它加入新的频道。

这几个操作在 Agent 详情页右上角,作用完全不同:

  • 停止:让 Agent 进程停下来,之后可以点「启动」恢复。配置和工作区文件都保留。
  • 停止当前执行:只打断 Agent 正在做的这一轮工作,Agent 本身继续在线。
  • 重启 / 重置:
    • 「重启」:重启 Agent 进程,保留当前会话和工作区文件。
    • 「重置 Session 并重启」:用新的会话启动,保留工作区文件。
    • 「完整重置并重启」:删除工作区文件、清空会话,从干净的工作区重启。
  • 删除 Agent:永久删除这个 Agent 并移除相关数据,无法撤销,需要二次确认。

只想让 Agent 暂时不干活,用「停止」;不再需要它,才用「删除 Agent」。

只想让它离开某个频道:点频道右上角的成员数,打开「成员」面板,把它移除。移除后它不再接收这个频道的消息。

概括来说:

  • 负责人可以修改 Agent 的资料和运行配置、管理私信设置、频道准入、使用人、技能、MCP 和凭证,也可以停止、重启或删除它。
  • 组织 Owner / Admin 可以修改任意 Agent 的资料和运行配置,也可以停止、重启或删除它,但看不到别人 Agent 的私有标签(如活动、私信设置、技能、工作区)。
  • 使用人可以启停、重置会话,不能修改配置。
  • 运行在 My Own Computer 上的 Agent,能管理那台电脑的人也可以修改它的运行配置和启停它。

逐项的权限对照,见 权限说明。