自動化 是附加到 工作流程 的觸發條件。工作流程說明要做什麼；自動化說明何時開始下一次執行。
自動化使用：
- 工作流程，連同其目前的程序
- 擁有者，會使用其自動化聊天和已連結存取
- 觸發條件，例如排程、來自已連結服務的事件，或傳入 webhook
每次執行會跑什麼
每次觸發都會在該工作流程與擁有者的自動化聊天中啟動一個新的執行。它不會在每次觸發時都建立全新的聊天。由同一位成員擁有、且針對同一個工作流程的自動化，會重用那個自動化聊天。
這次執行會使用工作流程目前的指示與觸發負載。由於聊天會被重用，較早的執行會保留在其對話串歷史中。若某個任務必須無狀態運作，請在工作流程指示中說明，並要求它只使用目前事件或明確的時間範圍。
模型是在自動化聊天對話串上選擇的，不是在代理或工作流程上。當自動化聊天首次建立時，其模型會先採用成員預設值，接著是工作區預設值。之後的觸發會重用為該對話串所選的模型。
打開自動化聊天即可查看其執行、輸出與可見錯誤。失敗的觸發也會保留在那裡，方便你更正工作流程、連接器存取或觸發條件，然後再次執行。
觸發條件參考
工作流程上的自動化選擇器是判定目前工作區可建立內容的權威來源。某些事件類型會在工作區功能開關之後才釋出，因此可能不會在所有地方出現。
排程
| 類型 | 行為 |
|---|---|
| Scheduled | 使用 cron 排程與 IANA 時區，按實際時鐘時間執行。 |
| Interval | 在一次執行完成後等待所設定的間隔，然後排定下一次執行。執行不會彼此重疊。 |
| Once | 在所選的日期與時間執行，然後自行停用。 |
儲存前請確認自動化中顯示的時區。需要依實際時鐘時間執行時請使用排程自動化；需要在完成後按間隔輪詢時，請使用間隔自動化。
Gmail
| 事件 | 篩選條件 |
|---|---|
| New message | 可選的 From、To、Cc、Subject 與內文文字比對器。若未設定比對器，所有新郵件都符合資格。 |
| Label applied | 一個 Gmail 標籤名稱。 |
先從嚴格的新郵件篩選開始，這樣繁忙的收件匣才不會產生意外數量的執行。
GitHub
GitHub 事件需要先在你的 GitHub 組織中安裝 Okou 的 GitHub App。如果尚未安裝，自動化設定畫面會明確說明——組織管理員會在那裡看到 Install GitHub App 按鈕，而其他人則會被提示請管理員處理。只要安裝一次，下方所有 GitHub 觸發條件就都會可用。
| 事件 | 常見篩選條件 |
|---|---|
| 拉取請求 | 一個存放庫和一個動作：opened、reopened、closed、ready for review、converted to draft、synchronized、added to or removed from the merge queue、labeled 或 unlabeled。可依基底分支、作者、PR 編號或標籤縮小範圍。對於 closed，你可以區分已合併與未經合併而關閉的情況。 |
| 工作流程執行完成 | 存放庫、工作流程、結論、分支、觸發事件和執行者。 |
| 工作流程作業完成 | 存放庫、工作流程、作業、結論、分支、執行器標籤和執行器群組。 |
| 拉取請求審查已提交 | 存放庫、審查狀態、基底分支、來源分支和值得信任的作者。 |
| 部署狀態已建立 | 存放庫、環境、狀態、ref、建立者、應用程式和正式環境旗標。 |
| Issue 或拉取請求留言已建立 | 存放庫、Issue/PR 範圍、值得信任的作者和留言前綴。 |
沒有單獨的 GitHub label applied 事件。若要對 PR label 做出回應，請選擇 Pull request、選取 Labeled 動作，並新增 label 篩選條件。
Google Calendar 和 Meet
- Calendar event created、updated 或 cancelled，範圍限於你選擇的 calendar ID
- Google Meet transcript generated，適用於由已連結成員所組織的會議
Chat 和其他整合
- Chat run finished 會監看你的其中一個聊天串。它可依 completed、failed 或 cancelled 狀態篩選；對於 completed 的執行，還可使用不區分大小寫的
*萬用字元，比對最終回覆。 - Webhook received 會建立一個已簽章的傳入 URL，並在工作區方案包含 webhook 自動化時可用。
- Google Forms response submitted、Notion page/database events、Strapi entry published 與 Stripe invoice paid 只會出現在已啟用這些自動化功能的工作區中。
事件自動化也需要相關的連接器或整合已連線並為自動化擁有者就緒。
自動化訊息會以白話描述發生了什麼，而由 chat run finished 觸發條件啟動的執行會回指到原始串。
建立自動化
從可運作的聊天開始。 先把任務當作一次性工作執行。當它產生你想要的結果時，請說：
"在洛杉磯時間每個平日的 8 a.m. 執行這個，並把結果 DM 給我。"
Okou 會確認工作流程、頻率與目的地，若工作流程尚不存在就先儲存，然後附加這個自動化。
明確建立。 在你的工作區中打開一個工作流程，按一下 Add automation，然後選擇觸發類型及其篩選條件。當你事先知道形式，而且不想先做一次試跑時，這很有用。
程序來自工作流程。在 My Okou 中，執行會使用自動化擁有者在該工作區內的個人指示（Instructions）、記憶、已連結帳戶與權限。在 Legacy Agents 中，擁有的代理程式會提供代理程式情境。排程觸發條件會詢問何時執行以及使用哪個時區。
公開工作流程共享的是方法，不是建立者的自動化或存取權。每位成員都建立並管理自己的自動化。不要假設複製工作流程會一併轉移其他成員的觸發條件、憑證或自動化聊天。
自動化可以個別啟用與停用，而不需要刪除——在你度假前，或是在除錯吵雜的觸發條件時，這是正確的做法。
目的地
自動化需要知道結果要送往哪裡。請在工作流程指示中說明：
- Slack 頻道或 DM — 最常見；會以訊息或串回到頻道中
- 飛書或 Microsoft Teams — 對於使用這些平台的團隊，概念相同
- Telegram 或簡訊 — 用於個人、以行動裝置為主的提醒
- Notion 頁面或資料庫 — 適合應該歸檔而非廣播的內容
- Google 文件或試算表 — 追加或覆寫
- GitHub issue 或 PR 評論 — 用於工程工作流程
- Gmail 草稿 — 先在你的帳戶中準備好，供你審閱並寄出
- 代管頁面 — 參見 託管網站
- 工作區檔案 — 當產出物是影片、圖片或可下載資產時
"發佈到 #engineering" 或 "DM 我" 比 "把它送到某個地方" 更清楚。
操作建議
以下內容來自正式環境中的自動化運行經驗：
- 觀察前三次執行。 自動化很容易設定；一旦看見 Okou 在你的環境中實際產生什麼，通常更容易調整。
- 把每個任務縮小。 又長又多步驟的自動化更脆弱。若單一個自動化必須更新五個系統，可以考慮拆成兩個。
- 釘住目的地。 頻道會改名，使用者也會離開。請在工作流程指示中明確寫出目的地名稱；若 Okou 在下次執行時找不到它，會發出警告。
- 為長時間查詢加上時間範圍。 如果提示要求「最近 30 天」，請在每次執行時都重述一次，讓時間窗保持最新。
- 確認時區。 排程與一次性自動化會儲存明確的時區；在儲存前請檢查顯示的值。
- 休假前先暫停。 尤其是會 DM 你的自動化——回來面對 14 則簡短 DM 並沒有幫助。將自動化停用，回來後再重新啟用；工作流程本身會保持不變。
費用與量級
自動化觸發會啟動一般執行，並可能依其使用的模型路由與服務消耗額度。估算成本時，請查看自動化聊天與 Billing。
短間隔會快速累積：若每次執行都在下一個間隔到來前完成，15 分鐘的間隔一天內最多可執行 96 次。過於寬泛的事件篩選也同樣會很吵雜。先從嚴格範圍開始，檢查前幾次觸發，然後再有意識地放寬篩選或頻率。
當你想停止新的觸發，但又不刪除其工作流程或歷史記錄時，請停用自動化。
