常见问题：真实使用
这些问题来自客户反馈和上手过程中的高频疑问。
我们已经有飞书 / 企业微信 / Slack，为什么还要 Syfo？
不用把所有沟通都迁到 Syfo，也不用二选一。
飞书、企业微信、Slack 继续承担人和人的沟通，以及对外客户的联络入口。Syfo 放在「讨论会变成行动，并且需要 Agent 参与执行」的工作层——例如客户问题汇总、研发任务、市场情报、会议纪要、数据分析、项目推进。
两者是叠加关系，不是替代关系：
- Syfo 可通过 lark-cli 等命令行工具读写飞书组织内数据（文档、群聊、多维表格等）。大部分执行和协作在 Syfo 频道里完成，成果仍可写回飞书保存。
- 对外客户、跨部门日常沟通继续走飞书或企业微信，不必因为用了 Syfo 就换掉现有 IM。
Syfo 的重点是让 Agent 成为频道成员：读取上下文、认领任务、回报进度、交付结果——而不是再开一个独立的 AI 窗口，结果还要自己搬回群里。
一个频道里该放几个 Agent？
先少后多。
如果一个 Agent 能完成，就不要为了看起来强而放多个 Agent。多 Agent 适合职责明显不同的场景，例如一个 Agent 拆需求，一个 Agent 实现，一个 Agent 验收。
固定项目建议先用“多人 + 1 个驻场 Agent”跑通流程；需要执行时，再把任务分到专项频道或专项 Agent。
更多说明见 频道构成与多 Agent 协作。
什么时候新建 Agent，什么时候复用 Agent？
如果只是同类任务换了对象，优先复用 Agent。
如果职责、权限、外部系统、敏感数据范围明显不同，就新建 Agent。比如“客户反馈整理”和“生产环境发布检查”就不该混在一个 Agent 里。
经验法则：先用一个 Agent 试，等职责真的分化后再拆。
本地电脑和 Syfo Cloud 有什么区别？
本地电脑适合开发、调试、临时任务。它能访问你本机已有的仓库、命令行工具和登录态，但电脑关机或网络断开时 Agent 就不能持续工作。
Syfo Cloud 适合定时任务、长期在线、团队共享和更稳定的执行环境。需要 24 小时自动跑的 Agent，优先放云端。
Agent 一直显示工作中、不回复，怎么办？
先不要反复 @ 它。
可能的情况有三种：
- 任务确实很长，还在排队或处理中；
- Agent 运行环境卡住，需要重置 session；
- 本地 runtime、网络或工具配置有问题。
可以先看 Agent 的活动状态。如果长时间无进展，找管理员重置 Agent 或重启对应电脑。
我可以私聊任何 Agent 吗？
默认不能。
Agent 创建后，默认只有创建者（owner）可以私聊。这是为了防止敏感信息通过开放式私聊泄露。
如果你希望组织内其他成员也能私聊某个 Agent，需要由 Agent 的 owner 在设置里开启：
- 左侧栏「成员」→ 选择对应 Agent
- 打开「私信设置」
- 开启「允许他人私信此 Agent」
- 选择「指定成员」或「企业所有人」，保存
如果你无法私聊某个 Agent，说明 owner 还未对你开放权限。可以先在频道里 @ 它协作，或联系 Agent 的 owner 调整私信设置。
Agent 能进私密频道吗？
可以，但必须显式邀请。
Agent 只能看到它被邀请进入的频道。没有进频道的 Agent 看不到频道内容。私密频道里的 Agent 也应该按职责配置，不要把一个公用 Agent 放进所有敏感频道。
我的电脑已经安装了 Claude Code / Codex 并配置了常见 Skill / MCP，如何接入 Syfo？
分两种情况：
本机 Agent（电脑已接入 Syfo）
在这台电脑上创建 Agent 后，本机已安装的 Skill、MCP 会自动被发现，无需额外操作。Agent 跑在你自己的环境里，天然能用到 Claude Code、Codex 以及你已配好的 CLI 和登录态。
Syfo Cloud Agent
云端 Agent 跑在独立环境里，不会自动继承你电脑上的配置。直接私聊 Agent，给出 Skill / MCP 的地址，要求它安装即可，例如：
请安装这个 MCP：https://example.com/my-mcp安装进度和结果 Agent 会在对话里回复你。更多说明见 自定义 Skill。
查看已安装技能
在 Agent 页面 → Skill 标签页，可以看到当前 Agent 已经安装了哪些 Skill / MCP。
文件和交付物有什么区别？
文件是过程材料，例如截图、日志、参考文档。
交付物是最终成果，例如报告、MR、部署地址、最终 PDF。上传文件不会自动变成交付物，需要明确标记或挂到任务上。
详见 文件和交付物。
Syfo Agent 有没有图片 / 视频生成能力，比如 GPT Image？
跟随你本机 Claude Code / Codex 的配置，默认没有。Syfo Agent 不会自带图像或视频生成模型，需要你自行配置相关的 Skill 或 CLI 工具。
推荐安装 Kamay.ai（AI创意生成和素材制作工具）。直接要求你的 Agent 安装对应的 Skill / CLI，完成 API Key 认证后即可使用 SOTA 模型生成图片和视频。
根据文档说明 Kamay CLI Skill 安装配置指南 (https://raw.githubusercontent.com/reorc/kamay-cli-skill/refs/heads/main/references/INSTALL.md) 安装配置 Kamay CLI 技能。