---
{
  "id": "platform.trigger.fire-events-and-debugging",
  "topic": "trigger",
  "title": "Trigger fire events 與除錯",
  "locale": "zh-TW",
  "version": "2026-07-17",
  "summary": "Trigger 除錯要拆成 match、queue、Agent execution、result recorded 四階段，並依 canonical fire status 與 retention 判斷。",
  "content": "先分開四個階段：resource event 已 match、dispatch 已進 queue、Agent 已執行 task、result 已記錄。`get_trigger` 顯示規則、replacement lineage、fire count 與 last-fire summary；fire-event query surface 提供近期 execution detail。create 或 match 成功都不代表 Agent execution 成功。\n\nCanonical run-result statuses 是 `success`、`partial`、`failed`、`skipped`、`timeout`、`unknown`。若事件沒有 fire，依序檢查 active/paused/cancelled、source type、event type 或 wildcard，再檢查 scope；要區分 event mismatch、scope mismatch、duplicate suppression 與 5 秒 debounce merge。paused 或 cancelled rule 不應建立新的正常 dispatch。\n\n接著查看 queued/delivered/skipped/failed、target availability、permission、rate limit、chain-depth guard 與 result recording。fire events 保留 90 天；offline target 有 300 秒 grace；stale in-flight 75 分鐘後 reclaim、stuck firing 5 分鐘後 recovery，已 delivery 但未記錄 result 的 task 3,660 秒後發 timeout notification。`record_run_result` 是 runtime bookkeeping。routing telemetry 不得保存完整 event payload 或 `systemMessage`。\n",
  "aliases": [
    "Trigger fire event",
    "事件沒有 match",
    "scope mismatch",
    "debounced event",
    "delivery failed",
    "Trigger timeout"
  ],
  "tags": [
    "trigger",
    "debugging",
    "fire-event"
  ],
  "relatedActions": [
    "arinova.trigger.get_trigger",
    "arinova.trigger.record_run_result"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/trigger/fire-events-and-debugging/"
}
---

先分開四個階段：resource event 已 match、dispatch 已進 queue、Agent 已執行 task、result 已記錄。`get_trigger` 顯示規則、replacement lineage、fire count 與 last-fire summary；fire-event query surface 提供近期 execution detail。create 或 match 成功都不代表 Agent execution 成功。

Canonical run-result statuses 是 `success`、`partial`、`failed`、`skipped`、`timeout`、`unknown`。若事件沒有 fire，依序檢查 active/paused/cancelled、source type、event type 或 wildcard，再檢查 scope；要區分 event mismatch、scope mismatch、duplicate suppression 與 5 秒 debounce merge。paused 或 cancelled rule 不應建立新的正常 dispatch。

接著查看 queued/delivered/skipped/failed、target availability、permission、rate limit、chain-depth guard 與 result recording。fire events 保留 90 天；offline target 有 300 秒 grace；stale in-flight 75 分鐘後 reclaim、stuck firing 5 分鐘後 recovery，已 delivery 但未記錄 result 的 task 3,660 秒後發 timeout notification。`record_run_result` 是 runtime bookkeeping。routing telemetry 不得保存完整 event payload 或 `systemMessage`。