回调协议

​

方向与地址

• 方向：AI 服务 → 后端
• 地址：后端提供并配置到 AI 服务的 AI_CALLBACK_URL，约定路径为 /internal/ai/callback

​

回调请求

{
  "request_id": "r2",
  "status": "succeeded",
  "...": "各接口的结果字段，见 API 参考"
}

{
  "request_id": "r2",
  "status": "failed",
  "error": {
    "kind": "provider_unavailable",
    "message": "...",
    "retryable": false
  }
}

​

投递保证

• 投递失败会自动重试 2 次，间隔约 14s、28s。
• 没有重试队列：重试耗尽后只记日志。后端不应假设回调必然到达——长时间未收到回调的请求，应按 request_id 主动对账或重新提交。
• 后端收到回调后只需返回 2xx；返回非 2xx 会被视为投递失败并触发重试，因此回调处理要幂等（按 request_id 去重）。