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,或实测端到端何时真正做完,我们暂时还没有测试;如果你用过,可通过网站底部站长联系方式反馈。上述说明仅供参考。独立调度费用、全部账号/地区是否开放,此处未核实。