Z Tag
管理组织

查看 IM 接入

在控制台查看本组织每个 Workspace 绑定的 IM 应用、安装与连接状态,以及它从组织继承的配置;商店版 ZAI 的工作区在这里用配对码连接与断开。

适用于组织 Owner / Admin

组织 Owner 和 Admin 在 组织管理 → IM 接入 查看本组织接入 IM 的每个 Workspace,以及 Z Tag 与它的 IM 应用之间的连接状态。每个 Workspace 对应一个 Slack 工作区里安装的 Z Tag 应用,一个组织可以有多个 Workspace,见一个组织接入多个 IM。

谁可以做:组织 Owner 和 Admin 可以查看;用配对码连接和断开只有组织 Owner 可以;我的资源 里没有这一页。

自建应用的行标注 自建应用 · 由 Z Tag 管理员配置:这些 IM 应用由 Z Tag 管理员配置,控制台只能查看,不能绑定、修改或删除。IM 平台上的应用怎样配置,见应用配置。商店版 ZAI(从 Z Tag 提供的安装链接装进工作区的 ZAI)的行标注 商店应用,它所在的工作区由组织 Owner 用配对码连接到本组织,也可以在这里断开,见用配对码连接与断开与本组织的连接。

页头的 用配对码连接 只接受商店版 ZAI 的配对码;组织只用自建应用时用不到它。

列表

每一行是一个 Workspace,列出平台、应用 ID、安装 状态与 连接状态,以及状态的上报时间。没有关联 Slack 工作区的 Workspace 不出现在这里。点击 Workspace 名称打开它的详情。

安装状态

安装状态表示什么怎么恢复
已安装应用正常安装在这个 Workspace—
需重新批准应用缺少当前版本需要的权限;ZAI 照常工作,只有用到缺失权限的功能会失败自建应用:请 Slack 工作区管理员按最新配置重新安装应用,再请 Z Tag 管理员更新应用凭证;商店版 ZAI:请工作区管理员从 Z Tag 的安装链接重新安装
需重新安装Slack 拒绝了这个安装的 Bot token:连接仍在,但 ZAI 无法在这个 Workspace 读写消息请 Slack 工作区管理员重新安装应用,再请 Z Tag 管理员更新应用凭证
已停用Slack 卸载了应用或撤销了它的凭证,ZAI 已停止在这个 Workspace 工作自建应用:请 Slack 工作区管理员重新安装同一应用,再请 Z Tag 管理员更新应用凭证;商店版 ZAI:见下文
未安装这个 Workspace 关联着 Slack 工作区,但当前没有生效的 IM 应用商店版 ZAI 断开后,请该工作区的工作区管理员重新获取配对码连接;自建应用需要恢复时,请 Z Tag 管理员登记应用

自建应用只在 Slack 重新安装还不够:Z Tag 管理员更新应用凭证后,这里的状态才随之变化。Workspace 详情里的 权限 列出已授予的权限,以及缺少的当前版本需要的权限;缺权限时,请 Slack 工作区管理员按上表重新安装应用。

商店版 ZAI 的状态随工作区的操作自动变化。工作区移除 ZAI 后显示 已停用,下方写明 工作区已卸载应用:工作区从 Z Tag 的安装链接重新安装后自动恢复,见卸载、重装与断开。已停用 下方没有原因时,是 Slack 拒绝了 ZAI 在这个工作区的调用;Z Tag 会自动重新核对,确认可用后恢复。重新安装 ZAI 之后仍一直显示 已停用、下方没有原因时,见常见问题:请断开连接,再由工作区管理员重新获取配对码连接。

连接状态

连接状态表示什么怎么处理
已连接Z Tag 正常接收这个应用的消息—
部分连接异常Z Tag 与这个应用的部分连接中断,消息仍由其余连接接收持续出现请联系 Z Tag 管理员
被平台拒绝IM 平台拒绝了这个应用,状态下方显示原因原因是 应用已被停用或卸载 时,请 Slack 工作区管理员重新安装应用,再请 Z Tag 管理员更新应用凭证;原因是 应用凭证被拒绝 时,请 Z Tag 管理员更新应用凭证
正在重试连接连接失败,Z Tag 正在自动重试几分钟后仍未恢复时,请联系 Z Tag 管理员
暂无状态没有收到这个应用的连接状态,通常是 Z Tag 的接收服务没有运行或正在重启持续出现请联系 Z Tag 管理员

Z Tag 同时用多条连接接收同一个应用时,状态旁会显示其中正常的条数,例如 2 / 3 个连接正常。

详情

点击 Workspace 名称打开详情:

  • 外部租户:显示 Slack 团队 ID。
  • 应用类型:商店应用 或 自建应用。商店应用另列 工作区名称。
  • 应用 ID、安装时间 和 最近变更。
  • 接收方式:长连接 或 HTTP 回调。长连接对应 Slack 的 Socket Mode,HTTP 回调对应 Slack 的 HTTP 请求地址。

从组织继承

详情还列出这个 Workspace 与组织内其他 Workspace 共享的配置:

  • 整个组织的资源:使用范围包含整个组织的资源,对这个 Workspace 的每个 Channel 生效。
  • 全体成员授权:对每位成员与 ZAI 的私信生效,也包括这个 Workspace 的成员。
  • 模型路由:Engine / Model 与 模型上游 的生效值和来源。

点开这一块的链接,会打开 范围设置 的对应分区,再在左栏选择这个 Workspace 查看。不想让某个 Workspace 继承的资源,请改为授权给具体的 Workspace、Channel 或成员,见范围设置;模型路由见配置模型路由与回复审阅。

用配对码连接

商店版 ZAI 装进工作区后,本工作区的工作区管理员在私信里向 ZAI 发送 !connect 获取配对码,见连接 Z Tag 组织。工作区管理员点配对码消息上的 在控制台连接 可以新建组织或连接到他担任 Owner 的组织;配对码交给你时,在这里连接:

  1. 在 IM 接入 页点 用配对码连接,粘贴配对码,点 查看。
  2. 核对工作区名、获取配对码的人和剩余时间。配对码 15 分钟内有效,只能使用一次。
  3. 确认数据共享范围:连接后,这个工作区里能使用 ZAI 的人都可以直接使用它,并与本组织共享成员、每位成员在组织内通用的记忆,以及授权给整个组织和全体成员的资源;这个工作区的频道和群聊及其记忆只属于它自己的 Workspace。
  4. 点 连接到本组织。列表里多出这个工作区的 Workspace,获取配对码的人会在私信里收到「本工作区已连接到一个 Z Tag 组织」的通知。

谁可以做:只有组织 Owner;Admin 看到的 用配对码连接 不可点,并提示 需要 Owner 角色。

配对码不能使用时(码不对、已过期、已被新码替换或已经用过),请工作区管理员重新获取。一个工作区只能连接一个组织:已经连接到其他组织的工作区,须先由那个组织的 Owner 断开。工作区移除了 ZAI 时也不能连接,重新安装后请工作区管理员重新获取配对码。

断开与本组织的连接

在商店应用的 Workspace 详情页头点 更多 → 断开与本组织的连接,输入工作区名称确认后断开:

  • ZAI 立即停止在这个工作区工作:进行中的任务取消,待发的消息不再发出;获取配对码的人会收到「本工作区与 Z Tag 组织的连接已断开」的通知。
  • Channel、记忆与历史留在本组织;经这个工作区加入的成员仍是本组织成员;控制台不能移除成员,需要时请联系 Z Tag 管理员。
  • 这个 Workspace 仍在列表里,显示 未安装。要重新连接,请该工作区的工作区管理员重新获取配对码;连接回本组织时沿用原来的 Workspace。

谁可以做:只有组织 Owner;Admin 打开 更多 时这一项不可点,并写明 需要 Owner 角色。工作区这一侧不能断开连接:从工作区移除 ZAI 只会让它停止工作,连接仍然保留。

本页目录