在控制台管理自己的资源
打开控制台,在我的资源里配置只供自己使用的连接器、设备和插件,查看自己的用量与模型设置。
控制台是 Z Tag 的网页管理界面。每位成员都可以在 我的资源 里配置只供自己使用的资源,查看自己的用量和设置;组织 Owner 和 Admin 还能进入 组织管理,见控制台的组织管理视图。
打开控制台
在 ZAI 的私聊或群里发送 /organization,点卡片上的 打开控制台,用当前的飞书账号登录。
直接打开控制台地址时,登录页会提示“请在飞书中发送 /organization,打开组织控制台。”,照做即可。
商店版 ZAI 的欢迎卡片和 /connect 回复上的 连接我的账号 同样打开控制台,用飞书账号登录,见连接我的账号。
入口对应收到命令的组织,登录后直接进入这个组织的页面。控制台的地址以 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 图片,调整缩放和位置,核对预览后点 保存头像。保存后,控制台里所有显示你的地方都使用这张头像。
- 你的初始头像取自飞书。之后即使你在 IM 里换了头像,控制台仍显示已导入的图片;暂时取不到时显示默认头像。
- 点 恢复初始头像 可以重新使用导入的图片;没有导入图片时,按钮是 恢复默认头像。
- 你在不同组织里的头像分别设置。
资源状态
资源列表和详情里的状态(例如 在线、离线、待接入、同步失败)表示什么、怎样处理,见:
无法进入时
| 你看到 | 这样做 |
|---|---|
| 尚未加入组织 | 回到这个组织的 ZAI,在私聊里重新发送 /organization,从回复里的链接进入 |
| 无法访问此组织 | 当前账号不属于这个组织。选择其他组织,或点 切换账号 换成正确的账号后,从 ZAI 回复里的链接重新进入 |
| 只有 我的资源,没有 组织管理 | 你的账号是普通成员。需要组织管理角色时,请 Z Tag 管理员设置;控制台里不能修改角色,见组织角色与权限 |
| 你看到 | 这样做 |
|---|---|
| 无法使用这个飞书应用 | 你的飞书账号不在应用的可用范围内,或账号状态异常。请飞书企业管理员把你加入应用的可用范围 |
| 飞书应用暂不可用 | 请飞书企业管理员确认企业已安装并启用这个应用;App Secret 已重置时,请 Z Tag 管理员更新 |
| 飞书暂时无法响应 | 稍后重新登录 |
| 打开别人分享的控制台地址后,无法进入组织 | 从你所在企业的 ZAI 发送 /organization,再点卡片上的 打开控制台 |
| 这个飞书应用属于其他企业 | 你所在的企业没有安装这个应用,例如打开了其他企业的同事分享的链接。在你所在企业的飞书里向 ZAI 发送 /organization,再点卡片上的 打开控制台 |
| 本企业还没有连接 Z Tag 组织 | 你所在的企业装了商店版 ZAI,但还没有连接组织。请本企业的应用管理员在私聊里向 ZAI 发送 /connect 完成连接,见连接 Z Tag 组织。你就是拿到配对码的应用管理员时,点页面上的 连接组织,粘贴配对码继续 |