OpenAI Agents API 文件寫明 Scheduled Automations:把「何時跑、送到哪個工作階段」存成日程。時機可以是 `periodic`(五段 cron `expression`+命名 `timezone`,例如 `America/New_York` 或 `UTC`),也可以是 `once`(未來的 Unix 秒級 `run_at`)。目標可以是 `new_session`(agent、environment 與初始 `input`),或 `existing_session`(工作階段 ID 與提醒用 `instructions`)。建立 automation 後狀態為 `active`,不會立刻跑;週期日程的首次執行是下一個匹配時間。

最容易踩的坑是 invocation 的 status。每次觸發會產生一筆 invocation,記錄「把任務送到目標工作階段」的嘗試。狀態從 `queued` 起,送達成功後變為 `completed`。對新工作階段,表示已接受初始 input;對既有工作階段,表示已接受 automation 通知並請求開工。completed 不等於 Agent 做完。要用 invocation 的 `session_id` 去追 session events 與 turn 結果,才能判斷工作是否真正完成。

定時與排隊也會影響監控與看板。日程寫的是計畫時鐘時間;Agents API 會在週期觸發上加一小段 隨機延遲 以分散負載。目標工作階段正忙時,任務會等工作階段空閒。計畫觸發不會打斷活躍 turn,也不會代填缺失的 tool result 或 approval——應用仍須自行處理 required actions。

暫停(pause) 或 刪除(delete) 會擋住後續計畫觸發(刪除還會擋住手動 invoke)。二者都不會停止工作階段已接受的工作;已在途的 delivery 仍可能送達。要停目前工作,需要 cancel 活躍 turn。

也可以替 agent 開啟 `automations` 工具,讓它在目前工作階段裡自管日程(建立、列表、更新、暫停、恢復、刪除)。API 會把目前工作階段設為目標;agent 不能用該工具開新工作階段,也不能管別的工作階段的日程。該工具預設關閉;應用不開啟也能自行排程。

建立介面仍在 Agents API 的 beta 面(請求頭 `OpenAI-Beta: agents=v1`)。面向有 Agents API 權限的開發者,不等於 ChatGPT 訂閱多了一項免費權益,也與 ChatGPT Team Tasks 不是同一產品——後者是 ChatGPT 工作區側的團隊自動化,不是 Agents API 工作階段日程。還可以看:ChatGPT Team Tasks 是什麼,怎麼計費。

對於在你自己的帳號上呼叫 create、列出 invocations,或實測端到端何時真正做完,我們暫時還沒有測試;如果你用過,可以透過網站底部站長聯絡方式回饋。上述說明僅供參考。獨立排程費用、全部帳號/地區是否開放,此處未核實。