检索与智能体的分阶段路线
第十八章包含两种执行方式：模型提出工具调用，程序执行后再把结果交给模型；或者由程序预先安排检索、回答、检查、确认和保存的步骤。先分别运行短例，再看它们共用哪些检索与存储对象。完整命令行和 HTTP 项目采用后一种方式。
下面按实际用到的知识补读。第一轮先使用项目附带的回放输出，运行过程可以逐项比较；走通后再读第十八章（三），替换成本机模型并检查同一组问题。
| 准备进入的内容 | 先读或回查的章节 |
|---|---|
| 消息链、检索和结构化回答 | 第一至六章；第三章的类型注解、迭代与生成器、装饰器；第四章的数据类、组合、继承与接口；第八章（十三）至（十九）的 HTTP；第十一章（一）至（十二）的数组、索引、广播、axis 与点积；第十二章（一）至（七）的请求与校验，再读第十三章（一）至（五）的路由与 Pydantic |
| 状态图、确认和失败恢复 | 第五章（七）（八）的上下文管理与 JSON、（十三）至（十五）的 SQLite、事务与连接关闭；第八章（七）至（十）的协程、事件循环、取消与收尾；第十七章（六）（七）的结构版本与幂等事务 |
| 完整命令行项目与环境重建 | 第三章（十七）的启动参数；第六章的测试、项目安装与构建；第十七章（二十二）至（二十七）的配置、日志、测试、真实进程、环境和安装包 |
| HTTP 入口和用户归属 | 第八章（十三）至（十九）的 HTTP；第十二章（八）至（十一）的账号、事务、会话与权限，以及（十八）（十九）的服务执行方式；第十三章（十）至（十三）的依赖与身份、（十八）的生命周期，再结合（二十一）至（二十三）启动与测试 |
| 阶段 | 第十八章的阅读范围 | 运行后检查的过程 |
|---|---|---|
| 带来源的检索问答 | （一）（二）→（四）至（七） | 解释一块文本怎样形成向量，筛选后选中哪些材料，材料怎样进入消息，引用怎样连回本轮原文 |
| 模型与工具交接 | （八）（九） | 对照 tool_round.py 的消息列表，区分模型给出的函数名与参数、程序执行的函数、工具返回的消息和下一次模型回答 |
| 状态推进与暂停恢复 | （十）至（十四） | 先用 node_reentry.py 跟踪两次进入节点，再用 checkpoint_walk.py 关闭重开检查点；用 crash_retry_walk.py 核对已提交记录怎样被同一次重试识别 |
| 完整任务与运行检查 | （十五）至（十八） | 检查停止条件、节点更新和失败输入，重建环境后运行学习助手；分别读取任务进度与正式计划 |
| 接入 HTTP | （十九），再做（二十）的扩展练习 | 发出请求后暂停，停止并重开服务，再确认原任务；核对当前用户、重复确认响应与数据库中的记录 |
每完成一行，再继续下一行。检索阶段先追踪材料与引用，工具阶段再追踪消息的交接；到了暂停恢复阶段，重点比较执行前后的状态、下一节点和业务表。这样读到框架接口时，已经知道程序正在替自己完成哪一个动作。