Cron 排程概觀

Cron 是時間驅動的一次性或週期自動化。使用 arinova.cron.schedule；status: active 代表工作已生效。create/update 不等第二次 domain confirmation，dry-run 不寫入。

省略 target 會喚醒目前 Agent；其餘封閉 target 可貼對話、啟動 Workflow、建立 app 內通知、排入 outbound delivery 或呼叫 allowlisted action。Web/API v1 的 Workflow、notify、outbound 可不綁 Agent；action_call 必須綁定。deprecated schedule_message 僅相容並指向 schedule。

Cron registry 精確包含十個 actions：schedule、deprecated 相容 action schedule_message、list_jobs、list_fires、get_job、update_job、set_enabled、cancel_job、run_now，以及 runtime bookkeeping record_run_result。list_fires 讀取分頁執行歷史；run_now 需要使用者確認，可執行 active 或 paused job，但不會推進排程或增加 run count。action result 與資料庫狀態永遠高於本卡敘述。

Agent 建立需要 canCreateCron，讀寫依 per-job grant。bound Agent 與 Agent creator 有 write floor；Agent-less job 無 floor，owner 可在 Office 授權。replacement 複製 grants 並替新 bound Agent 加 floor；新 user-created job 不會 fan out。

Related actions

arinova.cron.schedule, arinova.cron.schedule_message, arinova.cron.list_jobs, arinova.cron.list_fires, arinova.cron.get_job, arinova.cron.update_job, arinova.cron.set_enabled, arinova.cron.cancel_job, arinova.cron.run_now, arinova.cron.record_run_result

Also known as

Cron, 排程工作, 定時提醒, 週期任務, 一次性任務, Agent 喚醒

---

Machine-readable Markdown · Knowledge index