SAG / ARCHITECTURE NOTE
任务队列、重试与 dead letter：安全运行长时间分析
结合研究和官方文档，说明任务队列的定义与必要性、工作原理、在 SAG 架构中的应用标准，以及实用检查清单。
一句话定义
任务队列是一种将耗时较长的分析与请求分离，并明确管理状态、重试和失败隔离的结构。
核心回答：网络和外部服务会发生故障，Serverless 执行时间也有限制。将失败作为成功返回或无限重试，会带来成本和信任问题。
为什么需要这项技术？
网络和外部服务会发生故障，Serverless 执行时间也有限制。将失败作为成功返回或无限重试，会带来成本和信任问题。
工作原理
定义 queued、running、retryable、dead_letter、awaiting_review 等状态，并以原子方式进行状态转换。设置指数退避和重试预算，并将永久性失败交由运营人员审核。
设计时不能只关注准确性。还必须同时定义延迟、成本、数据边界、更新周期和发生故障时的行为，才能在运营中得到可复现的结果。对于自动化无法确定的值，安全做法是将其保留为未测量或需要审核的状态，而不是改成 0 或成功。
与 SAG 技术的关联
SAG job 会将中断的 running 恢复为 retryable，并在重试预算耗尽时将其隔离到 dead letter。长时间分析在写入 transaction 之外执行。
实用检查清单
- 定义状态转换表和允许的操作主体
- 对可重试的错误进行分类
- 制定 dead letter 的重新处理流程
- 将失败、空结果和权限错误的状态与成功区分开
- 在相同条件下重新验证变更前后的结果
研究与官方文档
参考文档为原理和建议提供依据。它们不保证搜索曝光、AI 提及、排名或营收；实际应用效果应通过服务数据和在相同条件下的观测加以确认。
如何继续了解这项技术
了解租户权限、任务重试、缓存和审批记录。
SAG / KNOWLEDGE LINKS