限制、保留时间与 ZAI 被移出时

常用限制

• 你发给 ZAI 的附件、它读取的频道文件和它发回的文件，单个默认不超过 512 MiB（Z Tag 管理员可以调整）。超过上限时，ZAI 只知道有这个文件、知道它超出了上限，取不到内容（图片例外：ZAI 改为读取 Slack 生成的缩略图）；更大的文件请先压缩或拆分。画布正文单份不超过 8 MiB，调高文件上限也不变；更长的画布，ZAI 读不到正文。
• 作为附件发出的文件还受 Slack 自己的上限约束，它比上面的默认上限小：Slack 单个文件默认 100 MiB（Z Tag 管理员可以调整）。在默认上限之内、但超过这个大小的文件，ZAI 照常生成和读取，只是发不成附件，原处改为一条说明；开启了下载链接时，说明里带着这个文件的下载链接。见获取生成的文件。
• ZAI 连接数据库（PostgreSQL、MySQL、MongoDB、Redis）或 SSH 时，每次连接最长一小时；这段工作结束、授权被收回，或资源、网络隧道被修改时会提前断开。正在进行的 Git 拉取或推送，在授权被收回或仓库配置被修改后，也会在几秒内停止。长时间的导入或迁移请拆成多步。
• 每项任务都在隔离的云端沙箱里运行，算力有限，不适合大规模计算或长时间训练。每个 Session 用一个自己的沙箱，同一个频道或群聊里的不同消息列也不共用。
• ZAI 在云端沙箱里以普通用户身份运行，没有管理员权限：不能用 sudo 安装系统软件包，也不能运行需要提权的工具。
• 沙箱配置把命令放到远程设备上执行时，上面两条换成那台电脑自己的算力，以及安装设备的系统用户的权限，见命令在哪里执行。
• 任务进行中新配置的资源，ZAI 可能还不知道，可以让它“重新查一下可用资源”。ZAI 每次真正使用资源前，都会重新确认这项资源在这里是否仍然可用。

其他上限写在各自的页面：

• 使用指令的长度：连接器
• 插件的大小：管理插件
• 远程设备的操作时长、并发数、文件大小，以及同时为多少沙箱执行命令：远程设备与网络隧道
• 重复定时任务的最短间隔：定时任务
• 事件订阅的数量和到期：订阅事件
• 单条记忆的长度：让 ZAI 记住、纠正或忘记
• 能读到多早的消息：能读到的历史；频道成员数的上限：访客与 Slack Connect
• Webhook 的数量和正文大小：Webhook 与事件
• Webhook 的请求频率和去重：Webhook 接入指南

Artifact 的限制

Artifact 是 ZAI 发布的文件链接，见用 Artifact 交付网页和文档。

• 发布的原文件单个默认不超过 8 MiB（Z Tag 管理员可以调整），为它生成的预览同样不超过这个大小。超过时 ZAI 会说明上限，并在不影响用途时压缩，或改用附件。
• 能发布网页、Markdown、PDF、Word、PowerPoint 和 Excel 文件，各自打开后的样子见让 ZAI 发布。
• ZAI 处理一次请求的过程中，最多发布 10 次，新发布和发布新版本都计入；其余的结果它会改用附件。
• 每个 Artifact 保留最近 10 个版本的内容，更早的版本只留下发布记录。
• Artifact 没有到期时间，发布后一直可以打开，直到被移除；移除不能撤销。
• 网页在隔离的环境里显示：不能保存数据到浏览器，不能把查看页换成别的网站，也不能自行发起下载；页面里的链接在新标签页打开。见网页里来自其他网站的内容。

ZAI 会记住一个消息列多久

ZAI 在消息列里完成最后一项任务后，默认 24 小时内没有再收到新任务，这段工作就结束：ZAI 清掉这个消息列的工作上下文和它生成的临时文件。之后在原消息列里追问，ZAI 会重新读取消息列内容和记忆，从头开始。正在进行的任务不受影响。

需要保留的结果，请让 ZAI 作为附件发回消息列。

ZAI 的回复里把这段连续的工作叫作 Session，例如 @zai !restart 的回复「已重启这个消息列的 Session……」，见你会看到的词。

想马上开始新的一段工作，可以另开一个消息列（在频道里另发一条 @zai 的新消息），或者在原消息列里发送 @zai !restart。后者会停止这个消息列里正在进行的工作，之前生成的临时文件也不会保留，见命令速查。新的 Engine 与 Model 设置从新的一段工作开始生效；新启用或更新的插件从下一条消息起生效，见技能与插件。

沙箱启动失败或中断时

ZAI 在云端的沙箱里执行任务；沙箱配置把命令放到独立执行沙箱或远程设备上时，执行命令的一侧另有本节最后的几种提示，见命令在哪里执行。沙箱出问题时，ZAI 会自动处理：

• 启动慢：沙箱比平时启动得慢时，ZAI 会在你等待的那条消息的消息列里提示「沙箱启动得比平时慢，任务会在启动后开始，请稍候。」，启动后任务照常开始。同一个消息列或私信里有几项任务在等时，每次启动只提示一次。
• 启动失败：ZAI 会自动重试；仍然启动不了时，等待中的任务失败，并提示「沙箱未能启动，请稍后重试。」。稍后重试或发一条新消息，ZAI 会重新准备沙箱。
• 运行中断：ZAI 先尝试恢复原来的沙箱，恢复不了就换一个新的。中断时正在进行的任务失败，并提示「沙箱意外中断，请重试。」；它不会自动重做，因为中断前可能已经改动了外部系统。还没开始的任务通常在恢复后照常执行，有时也会以同样的提示失败，重试即可。
• 恢复原来的沙箱或换到新的沙箱后，ZAI 会接着之前的上下文继续；换到新沙箱时，之前没发回消息列的临时文件不再保留。中断时有任务正在进行、之前的上下文没来得及保存或没能恢复时，ZAI 接不上之前的工作：它会在接着处理的那条消息的消息列里提示一次「之前的上下文没能恢复，任务会从这条消息重新开始；需要之前的内容时请重新说明。」，然后像开始新的一段工作那样重新读取消息列内容和记忆，见ZAI 会记住一个消息列多久。
• 连续几次换沙箱都没能完成任务时，ZAI 不再自动换，等待中的任务以同样的提示失败。
• 任务卡在启动中时，发送 @zai !stop 会立即停止它。

命令在独立执行沙箱或远程设备上执行时，还会遇到下面几种情况。它们都不会改在沙箱中执行，失败的只是这一轮，Session 保留：

• 执行命令的一侧没准备好或中断：这一轮还没开始执行就失败时，提示「执行环境暂时不可用，请稍后重试。」；执行中独立执行沙箱中断时，提示「执行环境中断，本轮未完成，请重试。」。独立执行沙箱换成新的之后，之前的文件和后台程序不再保留，ZAI 会在下一轮知道这一点。
• 远程设备在这一轮开始执行前不在：设备离线、正在更新，或同时执行的任务已满时，ZAI 最多等约 30 秒，设备在这期间回来就照常开始；电脑休眠或断网、连接还没断开却没有应答时，同样按离线等待。等不到时这一轮失败，提示说明原因，例如「执行命令的远程设备离线。……」。设备已停用、撤销关联、不在这个聊天的使用范围里或设备程序不支持时，不等待，立即失败。
• 远程设备在执行中断开：ZAI 等设备重新连上后接着执行；一段时间内没回来，这一轮失败，提示「与执行命令的远程设备的连接中断，本轮未完成。请确认设备在线后重试。」。设备程序重启或更新过、或者设备换了一台电脑时，之前留在后台的程序（换电脑时还有工作目录里的文件）不在了，ZAI 会在下一轮知道这一点。

各个提示怎样处理，见按现象排查问题。

保留时间

资源状态

控制台里资源旁的状态，例如已配置、在线、待接入、已同步，各表示什么、遇到时怎样处理，见各资源页：连接器、远程设备与网络隧道、插件。

ZAI 被移出频道时

ZAI 不在这里工作期间，各项功能按下表变化。

适用于 ZAI 被移出频道、频道被归档或删除、Z Tag 应用被卸载，以及频道与其他组织共享或有访客几种情况。频道被删除后不能恢复，其余情况这样恢复：

• 被移出：重新邀请 ZAI 进频道。
• 被归档：取消归档后自动恢复，不用重新邀请。
• 应用被卸载：重新安装应用，再请 Z Tag 管理员更新应用凭证，见卸载与重新安装；商店版 ZAI：从 Z Tag 的安装链接重新安装，它会连回原来的组织；再把 ZAI 邀请进原来的频道，见卸载、重装与断开。
• 共享或有访客：频道里重新只有本组织成员后恢复，见访客与 Slack Connect。

• 工作被停止时，已经发出的消息和已经完成的操作仍然保留。
• 之后点这个频道里消息上的按钮，会提示「我已不在这个聊天中，无法继续这项操作。」
• 除了资源申请的结果照常私信发起人，ZAI 不会另外私信通知发起人或任务负责人。恢复后，可以直接问 ZAI 某个定时任务或订阅那段时间为什么没有结果。
• 频道改名后，控制台里的 Channel 名随之更新。

ZAI 不能在频道里发言时

频道限制了谁能发言、ZAI 不在可发言的范围里时，仍可以 @zai，它会开始工作，但回答发不出去，触发消息上可能只显示失败表情。定时任务和事件订阅照常执行，回答同样发不出去，任务和订阅保持启用。

请改在私信里提问，或请频道管理者或 Slack 工作区管理员允许 ZAI 在这个频道发言。控制台会给这个频道加上标注，见Webhook 与事件。