LLM是大脑。马具是身体。版本1.0 — 2026年9月。一系列关于从基本原理构建AI代理的博客，已出版为书籍。📖 在线阅读：https://isuruwijesiri.com/harness-engineering-101/ LLM API是无状态的。每次交互时，您都将整个对话作为JSON数组发送，并接收文本回复。马具是构建、维护和保护该数组的程序。在这个领域所称的“代理”，都是对那一个环路的一组补丁，每个补丁的存在是因为某个具体的东西坏了。本系列在16章中展开这一想法，逐步开发一个约300行的简单Python代理。在这个过程中，所有的模式在One Code中都有完整的开发，这是一个基于pi的开源编码代理。通过上面的链接阅读呈现的书籍效果最佳。如果您更愿意在GitHub上阅读源代码，请按下面的章节顺序进行。完整的介绍在书籍的登陆页面上。阅读顺序每一章都有相同的结构：故障、最小补丁、补丁的成本。第一部分 — 线缆（没有什么是魔法的）# 章节 补丁的故障1 这只是一个JSON数组“我该如何与这个东西交谈？”2 大脑：下一个令牌黑箱“它为什么会那样行为？”3 工具：映射到函数的JSON大脑无法接触世界4 代理循环一个工具调用不够5 缓存：为什么顺序是承重的重新发送数组成本高昂第二部分 — 长期运行（数组承压）# 章节 补丁的故障6 上下文是预算，而不是包窗口填满7 子代理：分叉上下文一个数组无法容纳所有工作8 驾驶运行循环大脑在任务中漂移9 背景工作和时间循环是同步的；世界却不是第三部分 — 生态系统（命名您已经理解的事物）# 章节 补丁的故障10 每个框架都是对第一章的封装抽象焦虑11 扩展身体：MCP、技能、延迟加载、钩子能力无法适应数组12 调试数组您无法修复您看不见的提示第四部分 — 信任、领域和数据# 章节 补丁的故障13 反射和保护措施循环会做一些愚蠢的事情14 案例研究：编码代理身体需要多专门？15 RAG一直是马具模式千种名称皆为一种理念 epilogue 自建——完整的玩具马具，带注释附录——高级主题独立部分。需要时阅读它们。A. 一个马具，多个大脑——模型路由、提示层、成本工程B. 工作树和隔离——为并行代理提供独立的世界副本C. 模式和计划模式——马具强制的运行状态（特定于编码）D. 重试、速率限制和流媒体——不起眼的管道，以及流媒体如何在网络上运行仓库布局路径所包含的内容src/*.md章节和附录（书源）src/SUMMARY.md书籍的目录src/harness/可运行的玩具马具——每个阶段一个文件src/diagrams/图表生成器及其生成的PNG书籍.toml mdBook配置脚本/sync-to-blog.sh构建书籍并将其挂载到博客中以供服务本地构建书籍cargo install mdbook mdbook-mermaid # 或者：brew install mdbook（+ mdbook-mermaid二进制文件）mdbook serve --open # 在http://localhost:3000上实时重新加载预览mdbook build # 静态网站到./book mdbook-mermaid渲染内联的美人鱼图表；没有它，这些区块将显示为原始代码。再生定量图表cd src/diagrams && python3 gen_all.py # Python 3.10+，matplotlib许可证此仓库是双重许可的：散文——每章和附录（src/下的.md文件）——根据知识共享署名-非商业性使用-禁止演绎 4.0 国际（CC BY-NC-ND 4.0）许可。您可以分享并给予署名，但不可用于商业用途或发布修改版本。完整文本见LICENSE。代码——src/harness/和src/diagrams/下的.py文件，以及章节中从中复制的代码片段——根据MIT许可证授权。自由使用，并给予署名。© 2026 Isuru Wijesiri.