接入 Slack
Slack 工作区管理员须知
供 Slack 工作区管理员评估 Z Tag:谁可以安装和使用、卸载后会怎样、应用能读取什么、保存哪些数据。
适用于 Slack 工作区管理员与 Slack 应用管理者
本页面向批准安装 Z Tag 应用的 Slack 工作区管理员。创建自建应用的步骤见配置 Slack 应用;安装商店版 ZAI 见安装商店版 ZAI。
谁可以安装、谁可以使用
- Z Tag 在 Slack 上有两种接入方式,同一个工作区只用其中一种,两者都没有在 Slack Marketplace 上架:
- 自建应用:由你们的 Z Tag 管理员为本组织创建,请只安装到本组织自己的工作区,见配置 Slack 应用。
- 商店版 ZAI:从 Z Tag 提供的安装链接安装,再由工作区管理员用配对码把工作区连接到组织,见安装商店版 ZAI。
- 请把应用安装到单个工作区,不支持 Enterprise Grid 的组织级安装。
- Z Tag 不额外限制工作区里谁能使用:除访客外,工作区成员都可以在 ZAI 所在的频道里 @ 它,也可以私信它,用量计入组织。需要按人限制时,Enterprise 方案的工作区可以使用 Slack 自带的应用成员权限。
- 控制台只接受工作区的正式成员登录。访客(多频道访客和单频道访客)与已停用的账号登录时会看到 这个 Slack 账号不能登录,不能进入控制台。
- 与其他组织共享的频道(Slack Connect)和有访客的频道里,ZAI 不回复,也不运行后台能力;访客与其他组织的成员不能私信它。详见访客与 Slack Connect。
- 卸载应用或撤销它的 Bot token 后 ZAI 会怎样、怎样恢复,见卸载与重新安装;商店版 ZAI 见卸载、重装与断开。
应用能读取什么
- 读取它所在的公开频道、私人频道、群聊和与它的私信里的消息、消息下的表情回复与文件,以及频道的名称、主题和描述,用于回答 @ 它的请求、跟进它参与的消息列、读取历史,以及运行频道里开启的后台能力(免确认介入、主动协助和 Dream)。它不读取自己没有加入的频道。
- 发送、修改与删除自己的消息、添加表情回复、上传文件、打开与成员的私信。Artifact 消息里的预览图作为应用自己的文件上传到 Slack,Artifact 更新或被移除时,Z Tag 会删除旧的预览图。
- 读取工作区信息与成员资料:名称、头像、时区、语言、是否访客、所属工作区。
- 授予可选的画布权限(
canvases:read)时,读取消息里分享的画布正文。只在任务需要时读取,读到的是读取那一刻的内容;安装时可以不授予,画布就只显示名称和链接。应用不读取 Slack 列表的内容。 - 自建应用申请了加入公开频道的权限(
channels:join),商店版 ZAI 不申请;两者都不会自行加入频道,要由成员邀请。 - 应用不申请读取成员邮箱、搜索工作区、管理频道、读取置顶或代表成员发言的权限。
- 控制台的 Sign in with Slack 只申请
openid和profile;Slack 随登录签发的用户令牌不保存。
完整的权限清单见应用配置与权限。ZAI 用组织在模型路由中配置的模型生成回复;每次任务发给模型的内容,是完成这项任务所需的消息、文件与记忆。
保存哪些数据
| 数据 | 内容 |
|---|---|
| 消息索引 | ZAI 所在频道、群聊和私信里每条消息的时间、发送者与消息列关系,以及频道和群聊里的消息 @ 了谁(保留 35 天);正文不随索引保存,需要时实时向 Slack 读取 |
| 接收记录 | ZAI 收到的 Slack 事件原文,包括它所在频道里的消息正文,用于处理事件和排查问题 |
| 任务记录 | 每次任务(包括免确认介入、主动协助与 Dream 在后台做的分析)的输入、读到的内容、回复和执行过程,用于续接、审计和用量统计 |
| 文件 | 不超过默认大小上限的入站文件副本(包括读取过的画布正文;较大的文件不在收到时复制,ZAI 需要读取时才取回)和 ZAI 交付的文件,保留 30 天;上限见常用限制 |
| 记忆 | 从聊天记录与 Dream 中整理出的频道记忆、频道内个人记忆和其他个人记忆 |
| Artifact | ZAI 发布的文件、标题、版本,以及每次发布、修改和移除的记录,见用 Artifact 交付网页和文档 |
| 下载链接 | ZAI 给出的下载链接属于哪个文件和频道、由哪次任务给出,以及 Slack 拒收过的文件,见下载链接的访问 |
| 成员资料 | Slack 用户 ID、显示名、头像,以及资料里的时区与语言(不会写成 Z Tag 设置) |
| 应用凭证 | Bot token、Signing Secret、App-Level Token(Socket Mode 接收方式),以及开启控制台登录时的 Client ID 与 Client Secret |
Slack 免费版的工作区里,ZAI 只能读到最近 90 天的消息与文件,更早的读不到。