投递与重试
Dcision 如何投递 webhook、API 请求、工作流和智能体交接——至少一次,约七小时内尝试六次,遵循 Retry-After,以及超时、状态、重新发送和保留期。
Webhook、API 请求、工作流以及 async 模式下的智能体都属于投递:决策先作答,然后 Dcision 在后台发送它们。响应会告诉你哪些已进入队列:
{ "key": "notify_sales", "type": "webhook", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }至少一次
投递会至少发送一次。超时或丢失了回答的接收方会再次收到同一个投递,因此请利用投递 ID 使接收方具备幂等性——每次尝试和重新发送时它都相同:
| 类型 | 投递 ID 所在位置 |
|---|---|
| 全部 | Dcision-Delivery 请求头。 |
webhook | 事件的 id。 |
http、workflow、agent | Idempotency-Key 请求头(除非你设置了自己的);工作流中为 dcision.delivery_id,智能体为 decision.delivery_id。 |
投递不保证顺序:同一个决策——或两个决策——的两个投递可能以任意顺序到达。
尝试
| 尝试 | 时间 |
|---|---|
| 1 | 立即 |
| 2 | 第一次尝试后 30 秒 |
| 3 | 第二次尝试后 2 分钟 |
| 4 | 第三次尝试后 10 分钟 |
| 5 | 第四次尝试后 1 小时 |
| 6 | 第五次尝试后 6 小时 |
也就是说,约 7 小时内共 6 次尝试。Dcision-Attempt 请求头表明这是第几次尝试,每次尝试都会使用新的时间戳重新签名。
| 接收方…… | 结果 |
|---|---|
返回 2xx | 已投递。 |
返回 408、425、429 或 5xx,超时或无法连接 | 按上面的时间表重试。对于 429 或 503,Retry-After 请求头——以秒或日期表示——会改为决定等待时间,从 1 秒到 6 小时。 |
返回任何其他 4xx | 立即失败:修复目的地,然后重新发送。 |
返回重定向(3xx) | 立即失败:从不跟随重定向——请使用最终的 URL。 |
| 解析到非公共地址,或填入变量后 URL 无效 | 立即失败——参见安全与限制。 |
每次尝试的截止时间为 10 秒。Dcision 最多读取回答的 64 KB,并保存其状态码、延迟及前 1,024 个字符,应用会在投递旁显示这些信息。
状态
| 状态 | 在应用中 | 含义 |
|---|---|---|
PENDING | 发送中 · 重试中 | 等待下一次尝试。 |
SENDING | 发送中 | 一次尝试正在进行。因重启而中断的尝试会在 60 秒后被重新接手。 |
SUCCEEDED | 已投递 | 收到 2xx 回答。 |
FAILED | 失败 | 最终失败,或 6 次尝试均未成功。 |
在哪里跟踪它们:
- Playground 的结果以及执行记录中某次执行的详情会显示每个目的地及其实时状态、尝试次数、HTTP 状态和延迟、下一次尝试以及错误——对于
livemode: false的投递还会显示测试模式。 - 决策的概览按目的地统计已投递、失败和待处理的投递。
工作区中的每个人都可以查看投递;应用从不显示其请求体——只显示请求的遮蔽预览。
重新发送失败的投递
失败投递上的重新发送(Member、Admin 和 Owner)会以 6 次新的尝试和相同的投递 ID 再次将其加入队列,因此确实处理过它的接收方仍然可以去重。
渲染后的请求——包含其密钥——在投递可能需要它时会加密存储:投递成功时删除,失败的投递则保留,以便重新发送。重新发送发送的是同一个请求:对目的地或密钥的更改只适用于决策的新运行,不适用于重新发送。
速率与限制
- 一个工作区每分钟最多发送 600 个投递。超出的投递会等待下一分钟,不占用尝试次数。
- 响应不会等待投递:它们随运行一起进入队列,并立即在后台开始。
- 如果某个投递完全无法进入队列(队列不可用),其条目显示
"status": "skipped", "reason": "unavailable",决策仍然会作答。
保留期
已结束的投递——成功或失败——在创建 30 天后删除,与工作区的执行日志保留期无关。删除决策不会取消已进入队列的投递:它们会完成各自的尝试,并与其他投递一起过期。删除工作区会删除所有投递。
幂等性与重放
- 幂等重放会返回带有相同投递 ID 的已存储响应,不会再次投递任何内容。
- 使用相同
Idempotency-Key且仍在运行的请求会得到带Retry-After: 1的409——它永远不会运行或投递两次。 - 引擎错误 fallback 不会为幂等性存储:重试会再次运行决策,并以新的 ID 将新的投递加入队列。