ZAI 能用哪些团队资源
了解 ZAI 在不同聊天里能用哪些系统、设备和技能,凭证怎样保管,以及缺少资源时怎样申请。
ZAI 可以使用组织在控制台里准备的团队资源,例如业务系统的访问凭证、团队共用的电脑和插件。它能用哪些,取决于你在哪里发起任务。
在哪里能用哪些资源
- 在频道或群聊里:ZAI 只用组织允许在这个频道或群聊里使用的资源。这些资源可能专门为这个频道或群聊配置,也可能为更大的范围(例如整个组织)配置。不会因为某位成员在这里发言,就用上他自己的资源。
- 在私信里:ZAI 用你自己的资源,以及组织授权给你或全体成员的资源。你自己的资源在控制台的 我的资源 里配置,只在你和 ZAI 的私信里可用,见在控制台管理自己的资源。
两边的资源互不带入:频道或群聊里的资源不会带进私信,你自己的资源也不会带进频道或群聊。在消息里写其他资源的名称或 ID,不会扩大这个范围。
在私信里,你自己的凭证和组织提供的凭证都能访问同一个目标时,先用你自己的。
需要的资源在这里用不了时:组织允许申请的资源,ZAI 会在任务中替你提交申请,见申请使用资源;其他资源请组织 Owner 为这个频道或群聊开放,或授权给你。
有哪些资源
控制台里的团队资源分五类:
| 资源 | ZAI 用它做什么 |
|---|---|
| 连接器 | 按用途放在一起的一组访问能力,例如代码托管、制品服务或数据库的地址、凭证和使用指令 |
| 远程设备 | 一台已接入的电脑,ZAI 可以在上面执行命令、读写文件或操作桌面应用 |
| 插件 | 团队维护的技能说明、脚本和参考资料,告诉 ZAI 某类工作怎么做 |
| 沙箱配置 | 决定 ZAI 的沙箱能访问哪些网络地址,以及怎样进入企业内网 |
| 网络隧道 | 安装在企业网络里的程序,让获得授权的请求到达内网服务;它和 连接器 是两种不同的资源 |
ZAI 的沙箱里没有凭证值
连接器里的令牌、密码和私钥由 Z Tag 保管。ZAI 能看到的是连接器的名称、使用指令和不含凭证值的访问目标,它的沙箱里只有占位值;ZAI 访问匹配的地址时,Z Tag 自动带上真实的凭证值。所以不需要把凭证值发给 ZAI,也不要这样做。
能看到一个资源,不代表每次都能用上。ZAI 开始工作时会先了解有哪些资源可用,这份概览之后可能过时;每次真正使用资源前,Z Tag 还会再确认:
- 这个资源仍对当前的频道或群聊(或你的私信)生效;
- 凭证仍然有效;
- 需要的远程设备已启用且在线,需要的网络隧道在线。
任一项不满足,这次操作会被拒绝,ZAI 会收到失败原因,可以告诉你。业务系统自己的权限也照常生效:凭证对应的账号没有权限时,请求同样会失败。排查见按现象排查问题。
使用远程设备时说明目标
团队共用的电脑由组织接入,再开放给某个频道或群聊,或授权给指定成员、全体成员在私信里使用。你也可以把自己的电脑接入控制台,只在你和 ZAI 的私信里使用,见远程设备与网络隧道。
发任务时说清楚用哪台设备、哪个路径或应用,以及允许做什么。例如:
在“设计电脑”上读取
项目目录/交付清单.xlsx,只检查缺失字段,不修改原文件;把报告发回当前消息列。
- 有多台同名或相似的设备时,ZAI 会先列出候选,请你确认是哪一台。给设备起一个能区分的名字,可以省去这一步。
- 设备要已启用、在线,并支持你要的操作,否则即使有权限也用不了。例如没有图形桌面的机器不能操作桌面。
- 设备执行操作期间默认阻止系统休眠,但使用电池时不阻止,组织强制的休眠策略也优先生效;一旦休眠,进行中的操作会中断。屏幕锁定后,ZAI 无法操作桌面。需要调整时,在设备的本机管理界面打开 防休眠 页签,见维护远程设备。
技能
ZAI 自带一批常用技能,例如处理文档、表格、演示文稿和 PDF。想知道它现在有哪些技能,直接问它:“你有哪些技能?”
团队还可以把自己的做法整理成插件,由组织开放给频道或群聊,或随连接器一起提供。插件只提供做事的方法和资料,不会给 ZAI 额外的权限。插件更新后,ZAI 从下一条消息起用新版本,正在回复的那一轮不变,见技能与插件。
申请使用资源
组织可以为连接器、远程设备和网络隧道开放申请。当前的频道或群聊(或你的私信)还不能用某个资源、而组织允许申请时,ZAI 会在任务中提交资源申请,并先结束这次回复。
发起申请后
- 查看进度:在控制台的 审批中心 → 与我相关的申请 里打开这条申请。审批过程中,Z Tag 不会另外发消息告诉你进展。
- 审批结果:有了结果后,ZAI 发一条消息告诉你,写明为哪里申请、每个资源的结果,例如「已通过,使用范围已生效」或「审批未通过」;同一个任务的几项申请相隔不久都有了结果时,合成一条。在频道或群聊里发起的任务,结果发到你和 ZAI 的私信,频道或群聊里不发;ZAI 在私信里联系不到你时(例如它上一次发到你私信的消息没有送达,之后你也没有给它发过消息),以及自动执行、没有发起人的任务,结果留在原来的消息列里。发到私信的结果在发出时才被拒收的,不会再改发到消息列里,可以在控制台的 审批中心 → 与我相关的申请 里查看结果。在私信里发起的任务,结果就发在这个私信里。在频道或群聊里发起的任务因为需要的资源没有批准而停下时,原来的消息列里会有一句「所需资源未获批准,这项工作停在这里。」,不写是哪些资源、谁审批和原因。通过时,ZAI 会在原来的聊天里尝试继续原来的任务;原来的任务已经停止或结束时,不会自动重新执行,请重新发起。
- 生效范围:批准只对发起申请的地方生效,也就是这个频道或群聊(或你的私信);对频道或群聊的批准覆盖其中的每个消息列。网络隧道只能为你自己申请引用;频道或群聊需要访问内网时,申请指定了网络隧道的连接器。
- 不再需要时:申请还在审批中,可以在申请详情里点 撤回申请。停止任务不会让申请失效。
其他应用 @zai 发起的任务也可以提交申请,但这类申请不属于任何成员,不会出现在任何人的 与我相关的申请 里。其他应用的 @ 怎样处理,见其他应用的 @。
审批别人的申请
如果你被申请规则指定为审批人:
- 规则开启了通知时,ZAI 会在私信里发给你资源申请通知,列出资源、授权到哪里、申请人、申请理由和处理入口;规则分几个阶段时还写明当前阶段。处理入口是一个「在控制台处理」链接,点开进入控制台的审批页。通知按你的语言设置显示,授权目标里由 ZAI 补上的写法也一样,如「Alice 的个人范围」、没有名称的频道或群聊;Slack 里已有的名称按原样显示。语言设置见回复语言。
- 在控制台的 审批中心 → 待我审批 里打开申请,查看申请理由、授权到哪里和资源的使用指令。普通成员也能从 我的资源 进入审批中心。
- 按需要填写审批意见,再点 同意 或 拒绝。申请可能分几个阶段,依次审批。
全部阶段通过后,这个资源对申请的频道或群聊(或申请的成员)持续可用,直到组织撤销授权。