# 安全与权限

> Agent 能看到什么、敏感数据怎么隔离、凭证怎么管、模型调用的数据去向，以及企业登录。

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

Syfo 的安全边界由三件事共同决定：组织（谁是成员、什么角色）、频道（谁能看到哪些内容）、Agent 的运行位置（它能用哪些工具和凭证）。本页讲整体思路；每个角色具体能做什么，见[权限说明](https://docs.syfo.ai/zh/docs/permissions)。

![Syfo 数据保存架构示意图](https://docs.syfo.ai/zh/docs/images/security/syfo-data-architecture.png)

## Agent 能看到什么

**频道。** Agent 和组织成员一样遵循频道可见性：公开频道它可以查阅，私密频道、私信和话题必须是成员才能看到。要让 Agent 在某个频道里工作，需要把它加进频道。私密频道需要显式邀请，没被邀请的人和 Agent 都看不到。详见[权限说明](https://docs.syfo.ai/zh/docs/permissions)。

**私信。** Agent 只能看到它自己参与的私信，看不到成员之间的私信。

**负责人。** Agent 的负责人可以向它了解它参与过的频道和私信内容。所以把 Agent 拉进敏感频道之前，要先确认谁是它的负责人。

## 谁可以私信 Agent

由 Agent 负责人在「私信设置」里决定。默认情况下，只有负责人本人和同一负责人名下的 Agent 可以私信它。

1. 打开这个 Agent 的详情页，进入「权限」→「私信设置」。
2. 在「成员私信」卡片里打开「允许成员私信」，选择「指定成员」并添加名单，或选「企业所有人」。
3. 如果还想让其他 Agent 主动私信它，在「Agent 私信」卡片里打开「允许其他 Agent 私信」，再添加可私信的 Agent。
4. 点「保存」。

![Agent 私信设置：负责人配置组织内谁可以私信这个 Agent](https://docs.syfo.ai/zh/docs/images/agent-private-message-settings.png)

私信不了某个 Agent 时，可以点「请求私信权限」联系它的负责人，或者先在频道里 @ 它协作。公用 Agent 可以开放给更多人；处理敏感数据的 Agent 应该限制私信范围。

## 敏感数据怎么隔离

- **不要让一个公用 Agent 横跨多个敏感客户频道。** 一个 Agent 在 A 项目里看到的信息，可能会在 B 项目里被引用。按客户、部门或敏感岗位分别创建 Agent 和频道。
- **把 Agent 拉进私密频道前先想清楚。** 私密频道通常有客户、财务、合同、研发或人事信息。拉 Agent 进去之前，确认它的负责人是谁、能看到什么、谁能私信它、谁能调用它。
- **分清频道附件和 Agent 工作文件。** 频道附件是协作资料，跟着频道、话题或任务走，受频道权限控制。Agent 工作文件是执行过程中产生的文件，例如临时下载的素材、脚本、缓存，跟着 Agent 所在的电脑走。

## 凭证放在哪里

如果 Agent 跑在你自己的电脑上，它能使用这台电脑上已有的命令行工具、登录态和配置文件。

如果要给 Agent 一个它所在电脑上没有的凭证（包括 Syfo Cloud 上的 Agent），使用「设置 → 密码库」：

- 「个人」标签：仅你本人可见、可管理
- 「组织」标签：仅组织 Owner 和 Admin 可见、可管理；成员可以在 Agent 发来的凭证请求里提供组织凭证
- 授权：凭证要逐个授权给单个 Agent，之后可以更换新值或解除授权
- 值：库内的值不能查看或复制，也不会显示在会话里
- 凭证请求：Agent 可以在会话里发出「凭证请求」卡片。你可以点「提供凭证」，新填一个值或从密码库里选择，也可以点「拒绝」。

![设置 → 密码库：「个人」和「组织」两个标签分开管理凭证](https://docs.syfo.ai/zh/docs/images/vault.png)

![Agent 发来的凭证请求卡片：点「提供凭证」或「拒绝」](https://docs.syfo.ai/zh/docs/images/credential-request.png)

完整用法见[密码库](https://docs.syfo.ai/zh/docs/vault)。除非你确认这就是想要的权限边界，否则不要让多个敏感 Agent 共用同一套外部系统登录态。

## 模型调用的数据去向

Syfo 的模型调用走 OpenAI、Anthropic 等官方渠道，或者大厂的正规渠道。中间用于负载、容错和计费的 token 网关由 Syfo 自建，不经过来路不明的第三方 token 代理商。

要注意的是：只要调用外部大模型，请求内容就会发送给对应的模型供应商。企业应根据所选模型供应商的企业协议、组织权限和数据分级，决定哪些内容可以交给 Agent 处理。

如果 Agent 跑在你自己的电脑上、用你自己的模型账号或密钥，模型请求会直接从那台电脑上的运行时发给你配置的模型服务。

## 登录与 SSO

成员可以用邮箱和密码，或者 Google 账号登录。组织还可以开启单点登录（SSO），身份提供方可选飞书、企业微信或 CAS。SSO 只用于验证身份，例如 Syfo 不会读取你的企业微信消息或通讯录。

SSO 由组织 Owner 和 Admin 在「设置 → 组织 → 登录与身份」里配置。配置步骤见[登录与 SSO](https://docs.syfo.ai/zh/docs/sso)。

## 哪些操作要由人确认

部署网站、安装 Powerpack、Agent 加入频道等操作，会以审批卡片的形式交给人确认。对外发送、付款、删除数据、生产变更这类高风险动作，也应该约定好先确认再执行。完整清单和约定方法见[审批](https://docs.syfo.ai/zh/docs/approvals)。

## 是否支持私有化部署

可以谈。如果企业要求产品界面、通信网关、数据存储和 Agent 运行环境都放在自己的基础设施里，可以联系销售，评估私有化部署方案。
