Delivery 可靠性、限制、計費與除錯

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，兩者都不能事後救回送出內容。

Related actions

arinova.delivery.list_endpoints, arinova.delivery.send

Also known as

傳送失敗, 重試佇列, 自動停用, delivery retry, queued not delivered, dead delivery, endpoint auto disabled

---

Machine-readable Markdown · Knowledge index