文章定位
生产环境里的实战经验沉淀,适合拿来做方案评审、复盘和升级前检查。
阅读建议
先看标题和列表,再回到关键段落。技术文章更适合跳读和回查的结构。
适合场景
云原生、后端工程、系统设计、性能优化、故障处理和团队知识沉淀。
不要一上来就看 Prompt#
很多 Agent 项目第一次读源码时最容易犯的错误,就是只盯着 Prompt 看。真正该先抓的是执行链路。
五条主线#
我通常会按这五条线读:
- Runtime:请求怎么进入、怎么结束
- Tool Calling:工具如何注册、选择、执行
- Memory:上下文怎样压缩和恢复
- Planner:任务如何拆解与调度
- Delivery:日志、评测、部署怎么落地
Runtime#
先弄清楚谁在驱动状态流转。没有这个视角,后面读任何“模块设计”都会是碎片。
Tool Calling#
重点不是函数能不能被调,而是:
- 参数如何校验
- 权限边界如何约束
- 失败后如何重试或中断
Memory#
好的记忆系统不是“存得多”,而是知道什么值得保留,什么必须丢弃。
工程化建议#
读 Agent 项目时,尽量同步整理:
- 状态图
- 工具表
- 失败路径
- 外部依赖图
这样读到后面会越来越清晰,而不是越来越乱。