资源规则
能力在哪里生效
组织资源怎样按 Channel、Workspace、整个组织和个人范围生效,以及一次请求最终用到哪一份。
适用于组织 Owner / Admin
本页说明资源在哪里生效、一次请求最终用到哪一份,供配置资源时核对。怎样设置使用范围和授权优先级,见范围设置;成员看到的说明见ZAI 能用哪些团队资源。
Channel 与个人范围
控制台按聊天所在的范围决定 ZAI 可以用哪些资源:
- Channel:控制台对群的叫法。ZAI 在群里,可以用加到这个 Channel、它所在的 Workspace 和 整个组织 的资源。
- 个人范围:成员自己的那一层,对应他和 ZAI 的私聊。ZAI 在私聊里,可以用这位成员自己的资源,以及授权给他或 全体成员 的组织资源;不继承整个组织、Workspace 或任何 Channel 的配置。
- 全体成员:本组织所有有效成员的个人范围,以后加入的成员自动包括在内;成员离开组织后,这一来源对他失效。
两边的资源互不带入:成员在群里发言,不会让 ZAI 用上他自己的资源;群的资源也不会带进私聊。
各类资源怎样选定
| 资源 | 规则 |
|---|---|
| 连接器 | 对当前范围生效的连接器都可以用。群里是 Channel、Workspace、整个组织三层的连接器;私聊里是成员自己的、单独授权给他的和授权给全体成员的连接器。真正发出请求时,再按目标和优先级选出一份凭证或域名,见同一目标匹配到多份时 |
| 远程设备 | 同样按层累加,同一台设备只算一次;操作时设备还要已启用、在线。沙箱配置选来执行命令的设备也要在这里生效,选择本身不授权,见哪些设备可以选 |
| 插件 | 直接加到使用范围的插件,与随可用连接器启用的插件合在一起;同一个插件只加载一次。组织插件可以授权给全体成员;它不能单独授权给某位成员,但可以随授权给成员的连接器进入他的个人范围 |
| 沙箱配置 | 只有一份生效。群里:在 Channel、Workspace、整个组织中,取离它最近的一层所选的那份,都没有选时用组织的默认沙箱配置。私聊里:用成员为自己选的那份,没有时用他的默认沙箱配置。默认被取消、当前范围也没有任何选择时,只能访问连接器授权的目标。内网路由只从生效的那一份读取,上层沙箱配置里的路由不会合并进来,见沙箱配置与网络隧道。运行方式 和执行命令的设备同样取自这一份,见命令在哪里执行 |
| 网络隧道 | 本身不对任何聊天生效:由连接器或 模型上游 直接指定,或由生效的沙箱配置里的内网路由引用。组织网络隧道的 使用范围 只能授予指定成员或全体成员,表示他们可以在自己的资源里引用这条隧道 |
| 模型路由 | Engine 与模型、模型上游 各自按聊天所在的范围逐层选择,与资源的使用范围无关,见配置模型路由与回复审阅 |
同一目标匹配到多份时
连接器会累加,一个地址可能同时匹配几份凭证或域名。这时依次比较来源、范围、目标的精确程度和 授权优先级,选出一份:
- 来源:私聊里先用成员自己的,再用单独授权给他的,最后用授权给全体成员的。
- 范围:群里离它越近的一层越优先,Channel 先于 Workspace,Workspace 先于整个组织。
- 目标:主机和路径写得越具体越优先。
- 授权优先级:前几项都相同时,数值大的优先。
几项都相同、分不出先后时,请求会被拒绝,不会随机选择。请调整其中一份的 授权优先级,或把它的目标写得更具体,见授权优先级。内网路由的匹配规则见添加内网路由。
资源详情显示 来源 或 组织提供 时,先沿来源核对配置,不要在当前 Channel 重复创建同名资源。能管理一个资源,不等于它已对某个 Channel 生效,见管理原则。
组织、Workspace 与 IM
一个组织可以接入多个 IM 应用,每个接入在控制台里是一个 Workspace。ZAI 所在的每个聊天都属于一个 Workspace,群按 整个组织 → Workspace → Channel 取得资源。
组织 Owner 和 Admin 可以在 组织管理 → IM 接入 查看每个 Workspace 接入的应用,以及它从组织继承的配置,见从组织继承。新增或更换 IM 应用由 Z Tag 管理员操作,见新增或更换应用;商店版 ZAI 的企业由组织 Owner 用配对码连接与断开,见用配对码连接;多个 Workspace 共用什么、同一个人在不同 IM 里的账号是否关联,见一个组织接入多个 IM。