Z Tag
排障与参考

你会看到的词

ZAI 的回复和控制台里会出现、但不一定一看就懂的词,各是什么意思。

适用于所有读者

ZAI 的回复和控制台里有一些词保留了原样。下面说明它们的意思和会在哪里看到;控制台的标签按界面原样加粗,ZAI 回复的原文放在「」里。

ZAI 回复里的词

Channel

Channel 指 ZAI 所在的一个聊天:频道或群聊,或你和它的私信。这个词主要出现在控制台:范围设置里的 Channel 这一层只有频道或群聊,你和 ZAI 的私信在控制台里归个人范围;在 Webhook 的归属里,Channel 也包括你和 ZAI 的私信,见Webhook 与事件。没有名字的频道或群聊在控制台里显示为「未命名 Channel」,在 ZAI 发出的审批通知里显示为「未命名频道」。

Session

ZAI 在一个消息列里连续工作时保留的上下文和临时文件。消息列空闲一段时间后,这个 Session 就结束;之后再追问会开始新的 Session,ZAI 会重新读取消息列内容和记忆接着做,见ZAI 会记住一个消息列多久。

你会在这些回复里看到它:@zai !restart 的「已重启这个消息列的 Session……」,@zai !engine 和 @zai !model 的「配置将在新 Session 生效」,以及任务失败时的「Session 执行失败,请重试。」

沙箱

ZAI 执行任务的云端实例,它在这里运行命令、保存临时文件。每个 Session 用一个自己的沙箱:同一个频道或群聊里的不同消息列互不共用,Session 结束后沙箱随之释放。沙箱出问题时 ZAI 会自动重试或换一个新的,你可能看到「沙箱启动得比平时慢,任务会在启动后开始,请稍候。」「沙箱未能启动,请稍后重试。」「沙箱意外中断,请重试。」,见沙箱启动失败或中断时。它和控制台里的 沙箱配置 不是一回事:沙箱配置决定沙箱能访问哪些网络地址、命令在哪里执行,见沙箱配置与网络隧道。

Engine 与 Model

Engine 是 ZAI 做任务时使用的执行引擎,命令里写作 codex 或 claude,控制台里显示为 Codex 或 Claude;Model 是这个 Engine 使用的模型。@zai !engine 和 @zai !model 的回复会写「当前 Engine / Model:……」。新设置从新的 Session 开始生效,见命令速查。

Artifact

ZAI 发布的一份文件和它的固定链接,组织成员登录后在浏览器里查看和下载。ZAI 在回复里给出以标题为文字的链接,并在聊天里附上 Artifact 消息。它和附件不同:附件随消息发在聊天里,只有这里的人看得到;Artifact 的链接对全组织成员开放,见用 Artifact 交付网页和文档。

组织成员可下载的文件链接:拿到它的组织成员登录后下载原文件,没有预览、标题和版本。ZAI 应要求给出,回复里的附件 Slack 收不下时也会在原处改发,说明里写着「组织成员可见」。它和 Artifact 不同:Artifact 是在浏览器里查看的发布物,有标题和版本。谁能打开见下载链接的访问,什么时候出现见下载链接。

主动协助

ZAI 定期看频道或群聊里的讨论,觉得能帮上忙时,向相关成员提出建议,对方接受后才开始做。用 @zai !proactive on 开启,见主动协助。

免确认介入

开启后,ZAI 不必先问,就可以在频道或群聊里直接补充信息、主动研究材料,并在这里已有的明确委托范围内执行工作。用 @zai !proactive auto on 开启,见免确认介入。

Dream

ZAI 每天在后台整理频道的长期记忆,默认开启。用 @zai !dream status 查看它的状态,见Dream。

人与角色

组织 Owner / Admin

控制台里的两种组织角色。Owner 管理组织的资源和授权;Admin 可以查看组织的资源与用量,并维护其中一部分设置。ZAI 回复里的「组织 Owner/Admin」指的就是他们。组织 Owner / Admin 由 Z Tag 管理员设置,控制台里不能修改。各角色能做什么,见组织角色与权限。

Z Tag 管理员

为你的组织运行和维护 Z Tag 服务的人或团队,不是控制台里的组织角色。控制台 IM 接入 里的 由 Z Tag 管理员配置,以及 ZAI 回复里的「……联系 Z Tag 管理员」,指的都是他们。下面这些事需要找 Z Tag 管理员:

  • 登记或更换 ZAI 所在应用的凭证,或切换应用接收消息的方式。
  • 设置组织 Owner / Admin。
  • 调整默认上限,例如单个文件的大小。
  • 提供 Z Tag 访问外部系统时使用的出口 IP。
  • 开启插件和 Artifact 功能。
  • 提供 Git 提交使用的默认邮箱。

其他组织的成员

不属于 ZAI 所在 Slack 工作区的人,例如通过 Slack Connect 加入频道的成员;同一组织接入的其他 Slack 工作区的成员也算。ZAI 不在与其他组织共享的频道里工作,不执行他们发的命令;他们私信 ZAI 时只会收到一句说明,见访客与 Slack Connect。

访客是 Slack 工作区里只能进入部分频道的账号,不算其他组织的成员。ZAI 不在有访客的频道里回复,访客发的命令不执行,访客也不能私信 ZAI。

控制台里的词

范围设置

控制台里按范围管理设置的一页,侧栏在 概览 下面。左栏逐层选择整个组织、Workspace、Channel、成员或全体成员,右侧分 概览、Agent 设置、语言与地区、资源、Webhook 几个分区,改的是所选范围自己的设置,见范围设置。

使用范围

决定一项资源在哪里可以用的设置,也就是 范围设置 → 资源 分区里的授权;资源详情里也有同样名字的标签(连接器详情里是分区),二者的授权是同一份。它分为整个组织、Workspace、Channel、成员和全体成员几层,资源怎样按范围生效,见能力在哪里生效。

Workspace

控制台里的一层范围。一个组织可以有多个 Workspace,每个频道、群聊和私信都属于它所在的 Workspace,见一个组织接入多个 IM。

每个 Workspace 对应组织接入的一个 Slack 工作区。注意区分:“Slack 工作区”是 Slack 的概念,指你们在 Slack 里的团队空间;Workspace 是 Z Tag 控制台里的概念,记录这个 Slack 工作区接入的应用、其中的频道和它们的设置。

个人范围

控制台里属于一位成员自己的那一层范围,对应他和 ZAI 的私信:我的个人范围是你自己的,其他成员的显示为成员名加“的个人范围”。授权给某位成员的资源进入他的个人范围,在他和 ZAI 的私信里可以用。

全体成员

范围设置与使用范围里的一层,指本组织所有有效成员的个人范围,包括以后加入的成员。授权给全体成员的资源,每位成员在和 ZAI 的私信里都能用。

连接器与凭证

连接器是控制台里把一个服务的地址、凭证和使用指令放在一起的资源,ZAI 通过它访问业务系统,见连接器。凭证是连接器里的一条访问内容,由凭证值和访问目标组成:凭证值是密码、令牌、私钥或请求头这类证明身份的内容,访问目标是这份凭证允许访问的协议、主机、端口、路径和方法;ZAI 读不到凭证值,见权限、凭证与数据边界。远程设备和网络隧道在本机保存的身份证明叫本机凭证,与连接器里的凭证无关。

审批中心

控制台里处理资源申请的页面。ZAI 在任务中替你申请某项资源后,审批人在审批中心里批准或拒绝。申请规则开启了通知时,审批人还会在私信里收到通知:「资源申请待审批」和处理入口,见审批别人的申请。

本页目录