自动化是附加在工作流上的一个触发器。工作流定义“做什么”；自动化定义“何时”启动另一次运行。
自动化包括：
- 一个工作流，包括其所属的智能体
- 一个拥有者，其自动化聊天和连接访问会被使用
- 一个触发器，如计划、来自已连接服务的事件，或入站 Webhook
每次运行的内容
每次触发都会在该工作流和拥有者的自动化聊天中启动一个新的运行。它不会每次触发都新建一个聊天。由同一成员拥有的同一工作流的自动化会复用该自动化聊天。
运行会使用工作流当前的指令和触发器的负载。由于聊天被复用，早期的运行会保留在其线程历史中。如果某个任务必须无状态执行，请在工作流指令中说明，并让其只使用当前事件或明确的时间窗口。
模型是在自动化聊天线程中选择的，而不是在智能体或工作流中。当自动化聊天首次创建时，其模型会先采用成员默认值，然后是工作区默认值。后续触发会复用该线程已选择的模型。
打开自动化聊天可以查看其运行、输出和可见错误。失败的触发会保留在此，方便你修正工作流、连接器访问或触发器后重新运行。
触发器参考
工作流上的自动化选择器是当前工作区可创建内容的唯一依据。某些事件类型仅在工作区功能开关开启后才会显示，因此不一定处处可见。
计划
| 类型 | 行为 |
|---|---|
| 定时 | 按照 cron 计划和 IANA 时区在指定时间运行。 |
| 间隔 | 每次运行完成后等待设定的间隔，再安排下次运行。运行不会重叠。 |
| 一次性 | 在选定的日期和时间运行一次，然后自动禁用。 |
保存前请确认自动化中显示的时区。定时自动化适用于按时钟时间触发，间隔自动化适用于需要在完成后间隔一段时间再运行的场景。
Gmail
| 事件 | 筛选条件 |
|---|---|
| 新邮件 | 可选的发件人、收件人、抄送、主题和正文匹配条件。无匹配条件时，所有新邮件都符合条件。 |
| 标签已应用 | 一个 Gmail 标签名。 |
建议先用较窄的新邮件筛选条件，以免繁忙的收件箱产生过多运行。
GitHub
GitHub 事件需要 Okou 的 GitHub 应用已安装在你的 GitHub 组织上。如果未安装，自动化设置界面会提示——组织管理员会看到安装 GitHub 应用按钮，其他人则会被提示联系管理员。只需安装一次，以下所有 GitHub 触发器即可使用。
| 事件 | 常用筛选条件 |
|---|---|
| 拉取请求 | 一个仓库和一个操作：打开、重新打开、关闭、准备评审、转为草稿、同步、加入或移出合并队列、加标签或去标签。可按基础分支、作者、PR 编号或标签进一步筛选。对于closed，你可以区分已合并和未合并的关闭。 |
| 工作流运行完成 | 仓库、工作流、结论、分支、触发事件和执行者。 |
| 工作流作业完成 | 仓库、工作流、作业、结论、分支、运行器标签和运行器组。 |
| 拉取请求评审提交 | 仓库、评审状态、基础分支、头部分支和可信作者。 |
| 部署状态创建 | 仓库、环境、状态、引用、创建者、应用和生产环境标志。 |
| 议题或拉取请求评论创建 | 仓库、议题/PR 范围、可信作者和评论前缀。 |
没有单独的GitHub 标签已应用事件。要响应 PR 标签，请选择拉取请求，选择加标签操作，并添加标签筛选条件。
Google 日历与 Meet
- 日历事件创建、更新或取消，限定在你选择的日历 ID
- Google Meet 会议纪要生成，适用于由已连接成员组织的会议
聊天及其他集成
- 聊天运行完成 监控你的某个聊天线程。可按完成、失败或取消状态筛选，并可对已完成运行用不区分大小写的
*通配符匹配最终回复。 - Webhook 已接收 创建一个带签名的入站 URL，工作区计划包含 webhook 自动化时可用。
- Google 表单提交响应、Notion 页面/数据库事件、Strapi 条目发布和Stripe 发票支付仅在启用相关自动化功能的工作区中显示。
事件自动化还要求相关连接器或集成已连接并为自动化拥有者准备就绪。
自动化消息会用通俗语言描述发生的事件，由聊天运行完成触发的运行会指向原始智能体和线程。
创建自动化
从已验证的聊天开始。 先将任务作为一次性运行。确认结果符合预期后，可以说：
“每个工作日早上8点（洛杉矶时间）运行，并私信我结果。”
Okou 会确认工作流、频率和目标地，如果工作流尚未保存则会保存，并附加自动化。
手动创建。 在你的工作区打开一个工作流，点击添加自动化，选择触发类型及其筛选条件。适用于你已知需求且不希望先试运行的场景。
智能体和指令来自工作流本身，因此计划触发器只需询问何时运行及使用哪个时区。
自动化可以单独启用或禁用，无需删除——适合休假前或调试噪音触发器时使用。
目标地
自动化需要知道结果发送到哪里。请在工作流指令中明确说明：
- Slack 频道或私信 —— 最常见；以消息或线程形式发送到频道
- 飞书或 Microsoft Teams —— 适用于团队主要在这些平台的场景
- Telegram 或短信 —— 适合个人、移动优先的提醒
- Notion 页面或数据库 —— 适合需要归档而非广播的信息
- Google 文档或表格 —— 可追加或覆盖内容
- GitHub 议题或 PR 评论 —— 适用于工程类工作流
- Gmail 草稿 —— 在你的账户中准备好，供你审核和发送
- 托管页面 —— 参见托管站点
- 工作区文件 —— 适用于视频、图片或可下载资源
*“发布到#engineering”或“私信我”比“随便发到某处”*更清晰。
操作建议
以下建议来自生产环境中的自动化实践：
- 关注前三次运行。 自动化易于设置，实际看到 Okou 在你的环境中产出的内容后更易于优化。
- 保持任务简洁。 冗长、多步骤的自动化更易出错。如果一个自动化需要更新五个系统，建议拆分为两个。
- 明确目标地。 频道可能被重命名，成员可能离开。请在工作流指令中明确目标地；如找不到，Okou 会在下次运行时提醒。
- 限定长时间查询的时间范围。 如果提示要求“最近30天”，请在每次运行时重申该时间窗口，确保数据始终新鲜。
- 确认时区。 定时和一次性自动化会存储明确的时区；保存前请检查显示的值。
- 休假前暂停。 尤其是会私信你的自动化——回来后收到14条简报并无意义。请禁用自动化，回来后再启用；工作流不会丢失。
成本与频率
自动化触发会启动一次普通运行，并可能根据所用模型路径和服务消耗积分。估算成本时请查看自动化聊天和账单。
短间隔会迅速累积：如果间隔为15分钟，且每次运行都能在下次间隔前完成，则一天最多可运行96次。宽泛的事件筛选同样可能产生大量噪音。建议先用较窄的筛选，观察前几次触发，再有计划地扩大筛选范围或频率。
如需停止新触发但保留工作流或历史，可禁用自动化。
