FastAPI 练习与自测

健康检查用于负载均衡、容器编排与监控系统判断服务是否可用。它不应依赖外部 LLM，否则模型供应商抖动会让基础存活探针误判。

它把 API 合同显式化：输入校验、输出约束、OpenAPI 文档和测试样例都能复用同一份类型定义。

建议放稳定错误码、可读信息、trace_id。不要把敏感上下文和模型原始错误完整返回给用户。

适合聊天、长文本生成、Agent 多步骤进度等需要降低首字等待时间的场景。后台批处理或严格 JSON 输出不一定需要流式。

• POST /tasks 返回 task_id
• GET /tasks/{task_id} 返回 status/progress/result/error
• POST /tasks/{task_id}/retry 复用幂等键
• 表字段：task_id/user_id/status/progress/error_code/trace_id/created_at/updated_at

用 user_id + request_hash 作为幂等键；先查幂等记录，已有成功结果则直接返回；处理中则返回 task 状态；失败按策略允许重试。

限流可临时降级为本机内存或更保守的全局限额；任务状态真相应落 DB，Redis 只做加速和锁，不做唯一事实来源。