---
{
  "id": "platform.workflow.runs-and-debugging",
  "topic": "workflow",
  "title": "Workflow runs、外部 payload 與除錯",
  "locale": "zh-TW",
  "version": "2026-09-05",
  "summary": "從 concurrency、fuse notices、持久化 step output、actor 來源與外部 fire-event 冪等性診斷 pending 與 completed runs。",
  "content": "`maxConcurrentRuns` 預設 1；超出的已接受 run 維持 `pending` 等 capacity。`maxDurationSeconds` 預設 3,600，限制在 1–86,400。每個 Workflow 每 rolling hour 預設最多建立 10 個 runs，所有 status 都計入。`actorType` 是 `user`、`agent`、`webhook`、`cron`、`plugin_install`、`trigger` 或 `email`；搭配 run/audit detail 判斷 driver。\n\nVisit fuse 丟棄 traversal 會警告但仍可能完成。Template 缺值預設為空並留下 warning；`strictTemplates` 在 Agent、message、delivery 或 notification dispatch 前失敗並列出缺值，支援巢狀 trigger/先前輸出。Replay 讀取 persisted output。唯一 `source_fire_event_id` 讓重複 Webhook、Cron 或 Trigger fire 重用同一 run；終態事件增加 chain depth。\n\nH2A/group 啟動顯示即時 system card，只含 status/選填失敗 step。Failed/timed-out 預設通知 owner，`notifyOnFailure` 可關；completed 靜默。Webhook body 原樣傳入且上限 102,400 bytes。Cron 帶 `cronJobId`、`scheduledFor`、`message`、`metadata`、`firedAt`、`timezone`、`localDate`、`localTime`、`localWeekday`、`localDateTime`，local 值採 job timezone。actor/source fire-event ID 支援雙向 detail link。Cron 排程不需確認，直接 run Action 需確認。\n\n終態 step input/output 30 天後清除；終態 run 180 天後刪除，steps cascade、audit run reference 置 null。兩者每小時有界清理；到期前查 `get_run`、payload、iterations、notices 與 status。\n",
  "aliases": [
    "workflow run pending",
    "Workflow 除錯",
    "max concurrent runs",
    "workflow actor type",
    "webhook workflow payload",
    "cron workflow payload",
    "workflow idempotency",
    "workflow 對話結果卡"
  ],
  "tags": [
    "workflow",
    "runs",
    "debugging",
    "webhook",
    "cron"
  ],
  "relatedActions": [
    "arinova.workflow.run_workflow",
    "arinova.workflow.list_runs",
    "arinova.workflow.get_run",
    "arinova.workflow.cancel_run",
    "arinova.cron.schedule",
    "arinova.webhook.create_webhook"
  ],
  "relatedActionPrefixes": [],
  "sourceReviewedAt": "2026-09-06",
  "url": "https://docs.arinova.ai/zh-tw/kb/workflow/runs-and-debugging/"
}
---

`maxConcurrentRuns` 預設 1；超出的已接受 run 維持 `pending` 等 capacity。`maxDurationSeconds` 預設 3,600，限制在 1–86,400。每個 Workflow 每 rolling hour 預設最多建立 10 個 runs，所有 status 都計入。`actorType` 是 `user`、`agent`、`webhook`、`cron`、`plugin_install`、`trigger` 或 `email`；搭配 run/audit detail 判斷 driver。

Visit fuse 丟棄 traversal 會警告但仍可能完成。Template 缺值預設為空並留下 warning；`strictTemplates` 在 Agent、message、delivery 或 notification dispatch 前失敗並列出缺值，支援巢狀 trigger/先前輸出。Replay 讀取 persisted output。唯一 `source_fire_event_id` 讓重複 Webhook、Cron 或 Trigger fire 重用同一 run；終態事件增加 chain depth。

H2A/group 啟動顯示即時 system card，只含 status/選填失敗 step。Failed/timed-out 預設通知 owner，`notifyOnFailure` 可關；completed 靜默。Webhook body 原樣傳入且上限 102,400 bytes。Cron 帶 `cronJobId`、`scheduledFor`、`message`、`metadata`、`firedAt`、`timezone`、`localDate`、`localTime`、`localWeekday`、`localDateTime`，local 值採 job timezone。actor/source fire-event ID 支援雙向 detail link。Cron 排程不需確認，直接 run Action 需確認。

終態 step input/output 30 天後清除；終態 run 180 天後刪除，steps cascade、audit run reference 置 null。兩者每小時有界清理；到期前查 `get_run`、payload、iterations、notices 與 status。
