首页/AI/提示词工程速查/长任务的异步化

长任务的异步化

超过同步窗口的任务转异步:创建任务返回 ID,客户端轮询或订阅回调;任务状态机管理排队、执行、完成、失败与取消。

提示词工程速查AI更新于 2026-10-12

任务接口设计

任务接口设计
POST /jobs        → 202 {job_id, status_url}
GET /jobs/{id}    → {status, progress, result_url?}
POST /jobs/{id}/cancel
状态机: queued → running → succeeded | failed | canceled
超时: 单任务上限 30 分钟,超时转失败并保留日志
回调webhook 需签名校验与失败重试
轮询间隔退避,避免密集查询

易错点

  • 同步接口硬扛长任务,网关超时后用户重复提交
  • 任务状态不持久化,服务重启后任务丢失

数据来源与参考

  • 异步作业与任务队列通用模式;RFC 9110 中 202 Accepted 语义
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌