OpenAI Agents API 上线定时任务：Agent 能自己约下次检查

OpenAI 10 月 23 日（美国时间）在开发者论坛宣布，Agents API 加了定时自动化（Scheduled automations）。你可以用 cron 表达式让 Agent 每天、每周定点开一个新会话干活，也可以让它回到某个旧会话里继续跟进；打开 automations 工具后，Agent 还能在对话中途自己约下一次检查。

定时任务挂在会话上

按文档的说法，一次定时任务分三块：automation 存「什么时候跑、发给哪个会话」；每到点生成一条 invocation，记录这次投递；真正干活的还是 session，进度和结果要去 session events 里拿。

目标选 new_session 时，要给一个 agent（已保存的 agent_id 或内联配置，二选一）、一个环境（示例是 openai_hosted）和初始消息 target.input。选 existing_session 时只要会话 ID 和一段提醒文字 target.instructions，Agent 会带着之前的上下文和保存的状态继续做。文档举的例子是每两小时查一次餐厅空位，和上一次的结果对比后，只报新放出来的桌。

cron 按所选时区的钟点走：0 */3 * * * 是 0 点、3 点、6 点这样跑，不是从创建时刻起每隔 3 小时。周期任务还会被加一个小的随机延迟来分散负载。

Agent 可以自己约下一次

在会话的 agent 配置里加 {"type": "automations"}，Agent 就能创建、列出、查看、修改、暂停、恢复、删除自己的定时任务。官方示例用的模型是 gpt-6-astra，同时开了 multi_agent：主 Agent 只保留目标、日程和简短结论，每次到点的活交给子 Agent，详细的工具输出就不会一轮轮堆进主会话的上下文。

投递显示 completed，只代表会话收下了任务，不代表 Agent 已经干完。

权限上收得比较紧：这个工具默认不开；Agent 只能操作自己在当前会话里建的任务，创建者会记在 created_by 字段；从配置里拿掉工具，已保存的日程不会跟着删除，要另外用 API 暂停或删掉。

和自己跑 cron 比

试之前先看这几条

手动测试用 POST /v1/agents/automations/{id}/invocations，不带请求体。它不改日程，也不消耗一次性任务那唯一的一次；任务暂停时也能手动触发。invocation 的状态从 queued 变成 completed，source.type 区分手动（manual）和定时（automation）。

暂停或删除只影响以后的投递：已经被会话接收的活照样跑，要停得去取消正在进行的回合。一次性任务如果在暂停期间错过了时间，恢复前要先改一个新的 run_at。另一个容易漏的情况：到点时会话要是卡在等待工具结果或人工批准，定时任务不会替你补，得应用自己处理。

时间线上，Agents API 9 月 10 日开放公测，9 月 29 日加了 computer use，10 月 9 日加了沙箱预热和按活跃回合计费，10 月 16 日上了 Artifact SDK。这次定时自动化我们 10 月 24 日上午查 API changelog 时还没列出，日期以论坛公告为准。

SDK 这边我们在沙箱里装了 PyPI 上最新的 openai 3.37.0（10 月 22 日发布），client.beta.agents 下面有 sessions、environments、vaults，没有 automations。文档的 Python 示例要等新版 SDK，眼下可以照 cURL 示例直接调接口。我们没有 API key，没有实际创建过定时任务，也没测过随机延迟有多长、计费怎么算。

最后

已经在用 Agents API 的团队，可以先挑一个「每天汇总、每周复查」的活，用 once 加手动 invocation 试一遍，看 session events 里结果对不对，再改成 periodic。