5 分钟完成第一个任务

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

打开私信

在 Slack 里搜索 Z Tag（或你们组织为应用起的名字），打开它的应用页面，在 消息 标签页里给它发私信。Slack 里的应用名为 Z Tag，bot 显示名为 zai。搜不到时，请 Slack 工作区管理员确认 Z Tag 应用已安装到你们的工作区。

• 第一次打开 消息 标签页时，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 什么时候回应。