第 6 节 · 本站原创中文课程 · 建议 25 分钟
项目：最小 Pi 1.1 学习 Agent
学完能做：把循环、工具、编排、恢复与评测连接成可验证项目。
先做只读最小闭环
使用两份公开文档与一个假模型，分开 loop、model-adapter、tools、trace 和 tests。运行两回合：模型请求读取，工具给观察，模型输出带文档标识的摘要。程序限制步数、输出和超时。先本地证明闭环，再可选接入 Pi 1.1 的模型/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 和恢复重复调用八种情况。记录哪些是真实运行、哪些是设计或待测，模型定性评价不能代替这些断言。
看板状态与业务验收分开
1.1 的 OSC 7501 为支持它的终端报告 working、blocked、done、error 与 idle；取消后是 idle。报告不含提示和模型输出，但会携带会话名、对话框标题或错误首行。PI_PROGRAM_STATUS=1 强制发送，=0 关闭。你的项目可用假事件演示这些状态，同时独立记录八个业务案例的结果；看板显示 done 不代表结果正确或副作用可安全重试。
这是本站独立编写的讲解与示例，并非官方课程逐字翻译。理解之后，请完成下面的练习、自测和笔记。
参考来源：Pi v1.1.0 官方源码与文档