Z Tag
日常使用

在控制台管理自己的资源

打开控制台,在我的资源里配置只供自己使用的连接器、设备和插件,查看自己的用量与模型设置。

适用于成员

控制台是 Z Tag 的网页管理界面。每位成员都可以在 我的资源 里配置只供自己使用的资源,查看自己的用量和设置;组织 Owner 和 Admin 还能进入 组织管理,见控制台的组织管理视图。

打开控制台

在和 ZAI 的私信里发送 !organization,或在频道里发送 @zai !organization,点回复里的 打开控制台,再点 使用 Slack 登录。登录只读取你的 Slack 身份,不读取邮箱。频道里任务回复的页脚也有 控制台 链接。

直接打开控制台地址时,登录页会提示“请在 Slack 中发送 @zai !organization,打开组织控制台。”,照做即可。

商店版 ZAI 的欢迎私信和 !connect 回复里的 连接我的账号 同样打开控制台,用 Slack 账号登录,见连接我的账号。

入口对应收到命令的组织,登录后直接进入这个组织的页面。控制台的地址以 ZAI 回复里的链接为准,打开后可以收藏。

如果你也在另一个 IM 里使用 ZAI,那里是另一个账号:个人资源、记忆和用量不互通,控制台也要分别登录,见一个组织接入多个 IM。

退出登录

点侧栏底部的账号,在菜单里选 退出登录。退出后进入 已退出登录 页面,不会自动重新登录;要再次进入,在私信里重新向 ZAI 发送 !organization,打开回复里的链接。同一个菜单还可以切换浅色、深色或跟随系统的主题。

我的资源

我的资源 的侧栏最上面是 概览、范围设置 和 用量统计,其余页面分组列出:资源(连接器、插件、远程设备、沙箱配置、网络隧道)、授权(审批中心)和 IM 与 Webhook(Webhook);其中 插件 只在 Z Tag 管理员开启这项功能后显示。点组名可以收起或展开这一组,打开组里的页面时这一组会自动展开。侧栏可以收起成只有图标的窄栏,页眉的路径可以点击返回上一层。

  • 你在这里新建的资源只在你和 ZAI 的私信里可用,控制台把它们的生效范围叫作 个人范围。
  • 组织授权给你或全体成员的资源也列在这里,带 组织提供 标记,只能查看,不能修改。
  • 概览 显示你的用量概览、各类资源的数量,以及同步失败、已撤销、离线或待接入的 待处理资源;标题行的 新建 可以直接开始新建某类资源。
  • 范围设置 固定在你的 个人范围 上,列出其中可用的全部资源,按来源标注哪些是组织提供的;Agent 设置 和 语言与地区 两个分区也在这一页,见下面的模型路由与语言与地区。

新建和简单的编辑在对话框里完成;凭证、数据库与 SSH、Git 仓库、Kubernetes、申请规则、Webhook 事件定义和新建插件等较长的表单使用独立页面,保存或取消后回到原来的位置。还有未保存的修改时,关闭对话框、离开页面、刷新或关闭标签页前会先询问是否放弃本次修改:选 继续编辑 保留草稿,选 放弃修改 才会关闭。

连接器

在 我的资源 → 连接器 点 新建,按用途起名,再在详情里添加凭证或域名、填写使用指令。各服务的凭证怎样获取和填写,见服务与凭证配置;表单字段旁的 ? 也会打开对应说明。使用指令的写法见连接器,同样适用于你自己的连接器、远程设备和网络隧道。

  • 你自己的连接器和组织提供的连接器都能访问同一个目标时,先用你自己的。
  • 两份来源、范围、目标和优先级都相同的凭证、域名或内网路由同时匹配一个地址时,请求会被拒绝,不会随机选择;请把其中一份的目标写得更具体,或调整优先级,见范围设置。
  • 组织提供的连接器在列表里是纯文本,不能打开,只能查看;要用它,请让组织把它加进你的范围。

沙箱配置

沙箱配置 决定 ZAI 的沙箱在你的私信里能访问哪些网络地址,以及怎样进入企业内网。

  • 每位成员都有一份名为 Default 的默认配置,标有 默认沙箱配置,出网级别是 开放公网(保留拦截规则)。你另外指定一份之前,你的私信使用这份默认配置。
  • 你可以修改出网级别、新建沙箱配置,或添加内网路由,让请求经由网络隧道到达内网服务。内网路由可以使用你自己的网络隧道,或组织授权你引用的网络隧道。
  • 这套 Z Tag 服务开启了运行方式时,沙箱配置里还有 运行方式,默认 在沙箱中执行。选 在远程设备上执行命令 并选一台设备后,ZAI 在你的私信里执行的命令和文件操作都在这台设备上进行,以安装设备的系统用户身份执行,不受出网级别限制;可以选你自己的设备,或组织授权给你或全体成员的设备。各运行方式的区别和注意事项见命令在哪里执行。

各出网级别的含义、内网路由怎样匹配,见沙箱配置与网络隧道。

远程设备与网络隧道

  • 远程设备:在 我的资源 → 远程设备 新建一台设备,在你的电脑上执行对话框里的安装命令即可接入。安装命令只显示一次,其中的一次性接入凭证在对话框写明的 有效至 时间前有效。接入后,这台电脑只在你和 ZAI 的私信里可用。
  • 网络隧道:在 我的资源 → 网络隧道 新建的隧道,可以用在你自己的连接器、沙箱配置的内网路由和模型上游里。

接入步骤、凭证有效期与续期和组织的设备、隧道相同,见远程设备与网络隧道。本机的暂停、重新接入、取消接入与防休眠,见维护远程设备和维护网络隧道。使用设备时怎样说明目标,见使用远程设备时说明目标。

插件

在 我的资源 → 插件 点 新建,选 从 Git 同步 后从你自己的连接器里选一个 Git 仓库,填写版本和目录后同步;也可以选 上传插件,上传一个压缩包或单个 SKILL.md。个人插件只在你和 ZAI 的私信里加载。各字段、同步状态、版本与失败原因,见管理插件。

组织为你启用、在你和 ZAI 的私信里加载的插件也列在这里,带 组织提供 标记。点开只能查看:怎样启用给你、当前版本、说明与内容;暂不加载时带 暂不加载 标记,原因请问组织 Owner 或 Admin。

侧栏里没有 插件 时,说明这项功能还没有开启;需要时请 Z Tag 管理员开启。

Webhook

我的资源 → Webhook 列出你所在频道或群聊的 Webhook,以及你自己的连接器的 Webhook;你自己的连接器的 Webhook 只有你能看到和管理,组织 Owner、Admin 也看不到。你可以新建 Webhook、轮换凭证、定义事件,在 订阅 标签里暂停、恢复或移除订阅,并查看每次投递的结果。页面底部的 Channel 事件与内置事件 列出 ZAI 在这些频道或群聊里定义的事件(见让 ZAI 自己发出事件),以及频道或群聊自带的成员进出与新消息事件(见频道或群聊里的成员进出与新消息);可以暂停、恢复、移除订阅,ZAI 定义的事件也可以删除。具体操作见Webhook 与事件;在频道或群聊里订阅事件,见订阅事件。

ZAI 不在某个频道或群聊里之后,你就看不到这个频道或群聊的 Webhook 了,见ZAI 被移出时。

用量统计

我的资源 → 用量统计 只显示你自己的模型用量,也就是你和 ZAI 的私信里的用量。频道或群聊里的用量记在这个频道或群聊名下,由组织 Owner 和 Admin 查看。

这里没有 记账对象 和 Channel / 成员 两个筛选,其余用法(时间范围、Token 构成、导出 CSV)与组织用量相同,见查看组织用量。

模型路由

我的资源 → 范围设置 → Agent 设置 只作用于你的 个人范围,也就是只影响你和 ZAI 的私信。这一分区有三项:

  • Engine 与模型:ZAI 用哪种 Engine(Claude 或 Codex)和哪个模型工作。修改对新的 Session 生效,用命令修改时 ZAI 会回复「配置将在新 Session 生效」;Session 的含义见你会看到的词。
  • 模型上游:ZAI 调用模型时,请求发往哪个服务、带哪份凭证、是否经过网络隧道。你可以新建自己的上游(例如用自己的 API Key),选中后点 应用到此范围。
  • 回复审阅:ZAI 在私信里发消息前,是否先由审阅模型检查写法和语言。

没有在这里设置的项,沿用组织的设置或系统默认;每一项顶部的 当前生效 一行写明实际使用的值和它来自哪里。如果你在组织的多个 ZAI 应用里都有私信,而它们沿用的设置不同,这一行会显示 随一对一聊天所在的 Workspace 而定:各处的私信仍分别使用各自的设置;在这里设置一次后,所有私信都使用这个值。

也可以在私信里发送 !engine 或 !model 修改同一份设置,见命令速查。这些设置只决定 ZAI 怎样调用模型,不会让私信用上组织的连接器等其他资源。各项的完整说明见配置模型路由与回复审阅。

语言与地区

我的资源 → 范围设置 → 语言与地区 设置你自己的回复语言、办公地区和时区,作用于你和 ZAI 的私信、只发给你的提示,以及控制台显示日期、时间和数字的方式。怎样设置见回复语言、时区与办公地区。

头像

点侧栏底部的账号,在菜单里选 更换头像。选择不超过 5 MB 的 PNG、JPEG 或 WebP 图片,调整缩放和位置,核对预览后点 保存头像。保存后,控制台里所有显示你的地方都使用这张头像。

  • 你的初始头像取自 Slack 个人资料。之后即使你在 IM 里换了头像,控制台仍显示已导入的图片;暂时取不到时显示默认头像。
  • 点 恢复初始头像 可以重新使用导入的图片;没有导入图片时,按钮是 恢复默认头像。
  • 你在不同组织里的头像分别设置。

资源状态

资源列表和详情里的状态(例如 在线、离线、待接入、同步失败)表示什么、怎样处理,见:

无法进入时

你看到这样做
尚未加入组织回到这个组织的 ZAI,在私信里重新发送 !organization,从回复里的链接进入
无法访问此组织当前账号不属于这个组织。选择其他组织,或点 切换账号 换成正确的账号后,从 ZAI 回复里的链接重新进入
只有 我的资源,没有 组织管理你的账号是普通成员。需要组织管理角色时,请 Z Tag 管理员设置;控制台里不能修改角色,见组织角色与权限
你看到这样做
无法使用这个 Slack 应用登录的 Slack 账号不属于安装 Z Tag 的工作区,或账号状态异常。在 Slack 里切换到这个工作区的账号后重新登录
Slack 应用暂不可用请 Slack 工作区管理员确认应用仍已安装、没有被停用;凭证失效时,请 Z Tag 管理员更新
Slack 暂时无法响应稍后重新登录
打开别人分享或手动输入的控制台地址时,登录按钮不是 使用 Slack 登录回 Slack 发送 @zai !organization,从回复里的 打开控制台 进入
这个 Slack 应用属于其他工作区你登录的工作区没有安装这个应用。在 Slack 的授权页选择安装了这个应用的工作区,或者回你所在工作区的 Slack,从 Z Tag 发出的链接重新打开
这个 Slack 账号不能登录只有工作区的正式成员能登录控制台,访客和已停用的账号不能登录。你是正式成员时,稍后重新登录;仍然不行,请 Slack 工作区管理员确认你的账号状态和 ZAI 应用仍已安装
本工作区还没有连接 Z Tag 组织你所在的工作区装了商店版 ZAI,但还没有连接组织。请工作区管理员在私信里向 ZAI 发送 !connect 完成连接,见连接 Z Tag 组织。你就是拿到配对码的工作区管理员时,点页面上的 连接组织,粘贴配对码继续

本页目录