---
{
  "id": "platform.cron.overview",
  "topic": "cron",
  "title": "Cron 排程概觀",
  "locale": "zh-TW",
  "version": "2026-09-05.3",
  "summary": "Cron 以六種封閉 target 建立一次性或週期排程，包含 Agent-less 通知與對外派送，以及允許清單內的 Agent action。",
  "content": "Cron 是時間驅動的一次性或週期自動化。使用 `arinova.cron.schedule`；`status: active` 代表工作已生效。create/update 不等第二次 domain confirmation，dry-run 不寫入。\n\n省略 `target` 會喚醒目前 Agent；其餘封閉 target 可貼對話、啟動 Workflow、建立 app 內通知、排入 outbound delivery 或呼叫 allowlisted action。Web/API v1 的 Workflow、notify、outbound 可不綁 Agent；action_call 必須綁定。deprecated `schedule_message` 僅相容並指向 `schedule`。\n\nCron 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 與資料庫狀態永遠高於本卡敘述。\n\nAgent 建立需要 `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。\n",
  "aliases": [
    "Cron",
    "排程工作",
    "定時提醒",
    "週期任務",
    "一次性任務",
    "Agent 喚醒"
  ],
  "tags": [
    "cron",
    "overview",
    "scheduling"
  ],
  "relatedActions": [
    "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"
  ],
  "relatedActionPrefixes": [],
  "sourceReviewedAt": "2026-09-06",
  "url": "https://docs.arinova.ai/zh-tw/kb/cron/overview/"
}
---

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。