第 6 节 · 本站原创中文课程 · 建议 25 分钟
项目：最小 Pi 1.0 学习 Agent
本节保留 Pi 1.0.0 的引用与学习记录。阅读 Pi 1.1.0 对应章节
学完能做：把循环、工具、编排、恢复与评测连接成可验证项目。
先做只读最小闭环
使用两份公开文档与一个假模型，分开 loop、model-adapter、tools、trace 和 tests。运行两回合：模型请求读取，工具给观察，模型输出带文档标识的摘要。程序限制步数、输出和超时。先本地证明闭环，再可选接入 Pi 1.0 的模型/Agent API；不要把这里的伪代码宣称为能直接运行的完整 Pi SDK 示例。
持久化与恢复另做设计
1.0 的 durable Quick Start 用 Harness 与 MemoryStorage 演示，内存后端不跨进程保存。实际恢复可用 SQLite 或 JSONL：SQLite WAL 的进程崩溃保证与断电保证不同，JSONL 可配置 fsync。一次由一个进程拥有存储，没有跨进程锁。durable 承诺先提交再呈现，但外部工具副作用仍需幂等、完成标记或人工接管；恢复消息不等于安全重做写操作。
测试轨迹，而不只看最后答案
smoke.eval.ts 使用 noTools:all，问法国首都并检查 Paris、errors、provider/model 与 token。它是模型问答冒烟，不能证明工具或恢复可靠。你的项目至少覆盖空上下文、末尾 assistant、读取成功、工具失败、取消、预算耗尽、MCP isError 和恢复重复调用八种情况。记录哪些是真实运行、哪些是设计或待测，模型定性评价不能代替这些断言。
这是本站独立编写的讲解与示例，并非官方课程逐字翻译。理解之后，请完成下面的练习、自测和笔记。
参考来源：Pi v1.0.0 官方源码与文档