IsuruMaduranga/harness-engineering-101

它解决的问题

LLM API是无状态的：每次交互你发送整个对话作为JSON数组并得到文本回复。这使得构建代理变得令人困惑。本书澄清了所有被称为“代理”的东西只是对该循环的一组补丁。它解决了常见的失败，如模型丢失上下文、工具调用受限、数组过大，并解释了框架为何存在以及它们实际做什么。

工作原理

该系列贯穿16章，每章遵循相同的结构：失败、最小补丁、补丁的代价。它逐步用纯Python构建一个约300行的玩具代理。本书分为几个部分——The Wire（基础）、Running Long（处理长上下文）、The Ecosystem（框架和扩展）、以及Trust, Domains, and Data（护栏、编码代理、RAG）。还包括高级主题的附录，如模型路由、工作树、计划模式和重试/流式。完整源代码章节位于src/*.md，以及可运行的玩具harness在src/harness/和图表生成器。

适合谁

希望从根本上理解AI代理而不是仅仅使用高级框架的开发者。适合任何构建LLM应用的人，他们曾对代理框架的魔法感到困惑，或曾与上下文管理、工具调用或调试提示词作斗争。作者在构建WSO2 copilots和One Code编码代理中的实践经验使解释基于现实世界的教训。

亮点

• 从零开始用纯Python构建玩具代理，展示每一步增量。
• 每章遵循一致的模式：失败、最小补丁、代价。
• 涵盖基本主题：工具、缓存、子代理、上下文预算、引导、护栏、RAG等。
• 包括附录：模型路由、工作树隔离、计划模式、重试、速率限制和流式。
• 双重许可：文本采用CC BY-NC-ND 4.0，代码采用MIT，因此你可以自由重用代码。