Z Tag
资源规则

能力在哪里生效

组织资源怎样按 Channel、Workspace、整个组织和个人范围生效,以及一次请求最终用到哪一份。

适用于组织 Owner / Admin

本页说明资源在哪里生效、一次请求最终用到哪一份,供配置资源时核对。怎样设置使用范围和授权优先级,见范围设置;成员看到的说明见ZAI 能用哪些团队资源。

Channel 与个人范围怎样获得资源

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。

本页目录