← Back to 文字

API 验收清单

本文来自《AI 应用开发课程》月份 1 课程文档,已整理为网站文章版本。

必须通过的项目

  • 服务可以正常启动
  • /health 返回 200
  • /chat 使用请求模型与响应模型
  • /tools/run 使用请求模型与响应模型
  • 至少一个接口可通过 /docs 调试
  • 至少有一项自动化测试
  • 错误响应具备统一结构

加分项

  • 实现 /chat/stream
  • 日志中记录调用开始与结束
  • 关键错误可定位到具体阶段

未通过的典型表现

  • 项目只能本地脚本调用,无法服务化
  • FastAPI 路由文件里堆满核心业务逻辑
  • 模型调用逻辑散落在多个路由里
  • README 无法说明如何启动服务

如何使用这份清单

建议不要只在章节最后看一次,而是在做月份 1 第 3 周和第 4 周项目时反复对照:

  • 写完接口先看一遍
  • 准备录屏前再看一遍
  • 写 README 时再看一遍

这样这份清单才真正变成“验收工具”,而不是“阅读完就忘”的附录。

Fin