From-scratch(从零手写) 核心概念

别名: 手写

不依赖任何 Agent 框架、从最底层 HTTP 调用开始逐层手写的方法论。原理优先于封装:手写过一遍之后,你既能调试、能裁剪,也能看穿任何框架的抽象到底替你做的是什么。

它是什么

From-scratch(从零手写)指不依赖任何 Agent 框架、从最底层 HTTP 调用开始逐层手写的方法论:Agent Loop、工具系统、上下文管理、SSE 流式协议……每一层抽象都亲手写一遍,亲眼看见「框架魔法」背后的真实机制。本教程的两段式结构(拆解零件 → 装配整机)就是为这个方法论服务的。

为什么坚持手写

框架教学的最大成本是:当系统行为与预期不符时,你调试的是一个完全不了解的黑盒。第 01 章举了「Agent 无限调用同一个工具」的排障场景——停止条件为什么没触发,答案埋在框架深层的某个 while 里。手写过一遍之后,你能调试、能裁剪,也能看穿任何框架的抽象到底替你做了什么、藏了什么坑。

先手写、后选型

这不是「框架无用论」:真实生产里成熟框架非常值得用。第 23 章会反过来带读者读主流框架源码,到那时会发现框架的编排逻辑正是本书手写过的零件。Thorsten Ball 的《How to Build an Agent》证明了「LLM + 循环 + 工具」不到 400 行就能工作;build-your-own-agent 则是 Agent 技术栈 10 组件的 from-scratch 资源索引,可作延伸。

小结

用「先学加减乘除,再用计算器」类比最恰当:先手写、后选型,才有资格判断哪个框架的抽象更好、什么时候值得用。

相关词条

出现在这些章节