Agent Engineering.
从最小 Tool Loop 到事件流、状态恢复、评测和可控的多步执行,理解模型与 Harness 的职责边界。
适合人群
有编程经验,准备深入 Agent 工程与源码。
学习前提
能运行 Python 或 TypeScript 项目,具备 HTTP、JSON 和 Git 基础。
我的学习进度0 / 4 阶段
阅读验收标准、实际完成动手任务后再勾选。状态仅在当前浏览器保存,不表示项目测试自动通过。
课程正文.
本路线已有 1 篇独立原创讲义,包含实验、代码与验收。
四阶段路线.
不设强制时间,每阶段自行完成并核对验收标准。
阶段 01
最小 Agent Loop
学习要点
- 消息协议、Tool Calling 与模型输出解析
- 工具 Schema、请求关联 ID、终止条件
动手交付
一个含 2 个模拟只读工具的运行循环
验收标准
成功、非法参数、未知工具和最大轮数均有确定结果
阶段 02
Context 与记忆
学习要点
- 会话、摘要、检索和 Checkpoint 的差异
- 文件式状态持久化与恢复
动手交付
长任务的上下文管理与状态快照
验收标准
中断重启后仍能追踪步骤且不会丢失已确认状态
阶段 03
Harness 可靠性
学习要点
- 事件流、超时、取消和重试策略
- 权限门禁、幂等、错误预算
动手交付
结构化 trace 与 8 个故障注入用例
验收标准
故障不会无限循环;重复的写操作被规则约束
阶段 04
源码与系统评估
学习要点
- 对比 learn-claude-code 的教学结构与 Pi 的可扩展 Harness
- 测试集、延迟、token 成本和失败归因
动手交付
源码地图 + 架构决策记录 + 回归测试
验收标准
所有结论能链接到源码位置或复现实验
对应的开源项目.
基础 → 中级↗
shareAI-lab/learn-claude-code
循序学习 Agent Loop 与 Harness 组成方式
动手任务:拆出最小 Tool Loop 并自己实现异常路径
中级 → 深入↗
earendil-works/pi
阅读可扩展的 Coding Agent、工具与会话设计
动手任务:定位 agent core、工具回调、Session 与扩展点,写源码阅读地图
完成本路线后
交付可运行的单 Agent Harness、结构化事件日志和一套故障回归测试。
资料、代码与实验记录仅在经过检查后再公开发布。