5 分钟完成第一个任务

第一次使用建议从私聊开始。私聊里不需要 @ZAI，ZAI 在这里用你自己的资源，以及组织授权给你或全体成员的资源。

打开私聊

在飞书顶部的搜索框搜索 ZAI（或你们组织为它起的名字），打开和它的私聊，就可以给它发消息。搜不到时，请飞书企业管理员把你加入 ZAI 所在应用的可用范围。

发起任务

在私聊里直接发一条新消息（不在任何话题里回复），至少写清三件事：

• 对象：要处理哪份文件、哪段讨论或哪个系统。
• 动作：分析、整理、查询、生成，还是修改。
• 结果：希望得到文字结论、表格、文件，还是后续定时任务。

例如：

读取我附上的会议记录，提取已经确定的决定、负责人和截止时间，生成一份 Markdown 清单。无法确认的项目单独列出，不要猜负责人。

在原来的话题里继续

ZAI 会在这条消息的话题里回复。要补文件、纠正要求或追问结果，请在这个话题里继续：

把没有负责人的两项保留为空，并把最终清单作为文件发给我。

在私聊里另发一条新消息会开始一个新任务：ZAI 不会接着之前话题里的工作往下做。要沿用之前的结果，请回到原来的话题，或在新消息里说明要参考哪个话题的结果。

ZAI 什么时候直接做、什么时候先问你

ZAI 收到任务后先用手头的资料和资源把情况查清楚，只在少数情况下停下来问你：

• 直接做：查日志、查数据、读文档和聊天记录、在沙箱里复现问题。你让它修好或处理某件事时，能还原、只影响你说的那个对象的改动也直接做，例如在功能分支上修改并开草稿 MR、修改它自己发的消息和生成的文件；做完会说明改了什么、怎么还原。
• 只给结论：你只问原因或只要方案时，它给出诊断和具体修法，不动手修改。
• 先问你一次，例如：删除不是它这次创建的数据；改动生产环境，或重启、改动不是它为这次任务新建的测试环境；合并 MR、推送默认分支、修改 CI/CD 配置或重跑主分支和部署流水线；向这个聊天以外的人发消息、邮件，或在你没要求的地方发布内容；修改权限和共享设置；付费或对外承诺。你在消息里已经写明动作和对象时（例如“把线上 api 回滚到上一版”），它直接执行。
• 怎么问：需要你决定的事合成一条消息，每个问题附上它建议的默认做法，发出后继续做不依赖答案的部分。

这些是 ZAI 的工作方式，由它按约定判断，不是强制控制：必须由人把关的操作（例如合并到主分支、改生产配置），请在外部系统里用分支保护、权限等方式强制。想让它只给方案、先不动手，在原来的话题里说“先别动”；要中止正在进行的任务，见停止正在进行的任务，已经完成的操作不会自动还原。资源审批、网络出口和连接器凭证由平台把关，ZAI 绕不过；目标系统里的口令和密钥（如 Kubernetes Secret）它按约定不读取，请同时用资源权限限制它能读到的范围。

你会看到什么

ZAI 在你发的那条消息上用表情回复显示任务状态：

ZAI 拒绝处理的请求也会显示失败表情，所以看到失败表情不一定是任务本身出错。

这时 ZAI 通常会在话题里说明原因，例如群是外部群。群设置不允许 ZAI 发言时，它发不出说明，只能留下失败表情，见ZAI 不能在群里发言时。

在群里，没有 @ZAI 的跟帖和已经开始的主动协助也这样显示状态。定时任务和事件触发的任务没有你发的消息，状态显示在 ZAI 为这次运行发出的那条消息上；不开话题的定时任务和订阅没有这条消息，不显示状态，见不开话题的定时任务与不开话题的订阅。

任务需要分多步完成时，话题里还会出现原地更新的进度卡，显示任务清单和最近一条说明，见处理状态。

核对结果

处理中的表情、进度卡和「正在检索」这类中途说明都不代表任务已经完成，也不能代替最终结果。消息上还是处理中的表情时，任务仍在进行，包括 ZAI 在后台继续的检索。换成完成表情、收到最终结果消息或文件后，再确认：

1. 结果回到了发起任务的话题。
2. 请求的文字或文件真实存在。
3. 回复里明确说明了哪些部分未完成、无法验证或被拒绝。

结果不对或没有出现时，见按现象排查问题。

下一步：了解在哪里发起任务、ZAI 什么时候回应。