策略配置
策略模型
策略分三层下发(组织 → 部门链 → 用户),核心原则:授权按例外,安全只收紧。
- 每个维度有一个默认档(allow 或 deny),决定未显式声明的条目是否可用
- 在默认档之上,可逐条添加 allow / deny 例外
- 部门和用户例外可以覆盖组织声明的例外(更具体的规则优先)
默认档与例外
| 维度 | 默认档 | 说明 |
|---|---|---|
| models | allow | 默认全部可用,可用 deny 收紧 |
| skills | allow | 默认全部可用 |
| plugins | allow | 默认全部可用 |
| experts | allow | 默认全部可用 |
| apiKeys | deny | 组织自建 Key 必须显式 allow 才会下发 |
| connectors | deny | 官方/组织连接器必须显式 allow |
| upstream | 开 | 组织上游总闸:关闭后官方供应商全部不可用 |
连接器策略维度
| 子维度 | 说明 |
|---|---|
| official | 官方连接器 allow/deny |
| org | 组织私有连接器 allow/deny |
| allowLocalCustom | 允许用户自建本地自定义连接器 |
| allowUnsignedPackage | 允许导入未签名离线包 |
| tools.enabled | 连接器工具总开关 |
| tools.write | 写操作档 |
| tools.highRisk | 高危工具档 |
合并规则
合并顺序:组织 → 部门链(根→叶)→ 用户。
- 授权类(模型、技能、Key、连接器):逐条 allow/deny 例外,部门/用户例外可覆盖组织声明(更具体优先;同粒度时 deny 优先)
- 安全类(沙箱、DLP、审批):只能收紧不能放开——上级收紧后下级无法放宽
- 模型默认档只能设 allow(全部可见后用 deny 收紧),不能整体 deny
未配置 = 全开
未配置任何策略时:模型/技能/插件/专家默认全部可用;apiKeys 和连接器默认 deny(须显式放行才下发)。
引用格式
- 模型:
official:<provider>/<model>或org:<apiKeyId>/<model> - 技能/插件/专家:
official:<slug>或org:<slug>
用户最终策略预览
管理后台提供选定用户的最终策略预览:展示合并结果与实际可用模型/技能/插件清单。
策略校验
- 引用不存在的条目 → 报错不入库