---
{
  "id": "platform.delivery.reliability-limits-and-debugging",
  "topic": "delivery",
  "title": "Delivery 可靠性、限制、計費與除錯",
  "locale": "zh-TW",
  "version": "2026-08-09.1",
  "summary": "Delivery 只重試 transient failure，明確區分 queued 與 delivered，會自動停用異常 endpoint，且在 enqueue 時計費。",
  "content": "timeout、連線失敗、HTTP 5xx 是 transient，會在約 1 分鐘、5 分鐘、30 分鐘、2 小時、8 小時的基準上加 deterministic jitter；最多五次，耗盡成 `dead`。HTTP 4xx 與 redirect 是 permanent，直接 `failed`；HTTP 410 Gone 會停用 endpoint。連續失敗 20 次會轉 `auto_disabled` 並通知 owner；停用也會終止 queued／in-flight deliveries。canonical statuses 是 `queued`、`delivering`、`delivered`、`failed`、`dead`，Pull 另有 `acked`。\n\nenqueue 有每 endpoint 每分鐘 60 次 token bucket，以及每 owner 每 UTC 日 1,000 次配額；直接 Agent send 與 Workflow delivery step 共用兩種配額。Redis 判定不可用時 fail closed；被拒不扣款。Service 的 serialized payload 上限 256 KiB。64 KiB total argument envelope 只套用直接 `arinova.delivery.send` Action；Workflow step 不經過該 Action，但仍受自身 graph 與 rendered payload bounds。過大資料應另行上傳後只送連結。enqueue 成功立即扣 credit；目前 runtime 對後續 `failed`／`dead` 不自動退款。終止態歷史保留 30 天。\n\n除錯先看 action typed error：`resource_not_found` 代表 endpoint 不存在或未授權給此 Agent，刻意不區分兩者；`resource_conflict` 是 endpoint 未 active，請 owner 到 Office > 送出傳遞 verify／enable；`permission_denied` 附 top-up，`rate_limited` 附重試資訊，`invalid_arguments` 涵蓋 event 格式或大小。再請 owner 查看 delivery history 與 endpoint failure count，絕不可把 `queued` 說成已送達。Delivery history 刻意不保存 payload，Workflow run detail 也只有 `contentBytes`，兩者都不能事後救回送出內容。\n",
  "aliases": [
    "傳送失敗",
    "重試佇列",
    "自動停用",
    "delivery retry",
    "queued not delivered",
    "dead delivery",
    "endpoint auto disabled"
  ],
  "tags": [
    "delivery",
    "reliability",
    "limits",
    "debugging"
  ],
  "relatedActions": [
    "arinova.delivery.list_endpoints",
    "arinova.delivery.send"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/delivery/reliability-limits-and-debugging/"
}
---

timeout、連線失敗、HTTP 5xx 是 transient，會在約 1 分鐘、5 分鐘、30 分鐘、2 小時、8 小時的基準上加 deterministic jitter；最多五次，耗盡成 `dead`。HTTP 4xx 與 redirect 是 permanent，直接 `failed`；HTTP 410 Gone 會停用 endpoint。連續失敗 20 次會轉 `auto_disabled` 並通知 owner；停用也會終止 queued／in-flight deliveries。canonical statuses 是 `queued`、`delivering`、`delivered`、`failed`、`dead`，Pull 另有 `acked`。

enqueue 有每 endpoint 每分鐘 60 次 token bucket，以及每 owner 每 UTC 日 1,000 次配額；直接 Agent send 與 Workflow delivery step 共用兩種配額。Redis 判定不可用時 fail closed；被拒不扣款。Service 的 serialized payload 上限 256 KiB。64 KiB total argument envelope 只套用直接 `arinova.delivery.send` Action；Workflow step 不經過該 Action，但仍受自身 graph 與 rendered payload bounds。過大資料應另行上傳後只送連結。enqueue 成功立即扣 credit；目前 runtime 對後續 `failed`／`dead` 不自動退款。終止態歷史保留 30 天。

除錯先看 action typed error：`resource_not_found` 代表 endpoint 不存在或未授權給此 Agent，刻意不區分兩者；`resource_conflict` 是 endpoint 未 active，請 owner 到 Office > 送出傳遞 verify／enable；`permission_denied` 附 top-up，`rate_limited` 附重試資訊，`invalid_arguments` 涵蓋 event 格式或大小。再請 owner 查看 delivery history 與 endpoint failure count，絕不可把 `queued` 說成已送達。Delivery history 刻意不保存 payload，Workflow run detail 也只有 `contentBytes`，兩者都不能事後救回送出內容。