DOCAI · 学习路径 · L2
开发者路径：从第一次调用到能上线
给会一点编程、还没接过模型 API 的人：先跑通一次请求，再处理流式、错误、成本和检索，最后把工具循环与上线清单走完。
顺序为什么是这样
先跑通，再谈优化。看懂和跑通之间差着一次 401——只有亲手发过请求，后面的报错排查才有落点。
跑通之后按「接进代码 → 处理流式与超时 → 看懂错误 → 控制成本 → 检索 → 用工具 → 上线检查」推进：每一步都建立在上一步能跑的前提下。
卡住的时候
课程地图
08按顺序学；括号里是预计时长。
- 01第一次 API 调用：10 行 curl从环境变量里读 key，用一条 curl 发出第一个请求，再逐段看懂响应。跑通之后，所有框架都只是把这十行包起来。20 分钟
- 02把模型接进自己的代码从 curl 过渡到代码：用环境变量管 key、用 SDK 或 HTTP 发请求、把 base URL 和模型名做成配置，出问题能逐层定位。30 分钟
- 03流式输出与超时设置打开流式、逐块拼接文本、给首字节和总时长各设一个超时：让用户早点看到字，也让卡住的连接能自己退出。25 分钟
- 04读懂一次 API 报错拿到报错先看状态码、再看响应体的 type 与 message：三步把「一句话」定位到具体环节，而不是靠猜。20 分钟
- 05算清一次请求的成本输入 token、输出 token、单价三个变量决定一次调用花多少钱；重试和上下文重发是最容易被忽略的开销。20 分钟
- 06搭一个最小可用的 RAG三份文档、一次向量化、一次检索、一次回答：不装框架，用最少代码看清 RAG 的每一步在哪出错。40 分钟
- 07给模型一个工具，让它自己用定义一个函数、把它的结构告诉模型、执行模型返回的调用、再把结果发回去：亲手跑一遍工具调用的完整回合。35 分钟
- 08上线前的检查清单鉴权、超时、限流、成本、日志、回滚：六项过一遍，比上线后救火便宜得多。25 分钟