https://blog.lucasma.cc/categories/langchain/ Recent content in LangChain on Lucas Ma 的博客 Hugo zh-cn 2026 Lucas Ma Mon, 08 Jun 2026 22:01:37 +0800 https://blog.lucasma.cc/posts/langchain-custom-agent-harness/ Mon, 08 Jun 2026 22:01:37 +0800 https://blog.lucasma.cc/posts/langchain-custom-agent-harness/ <p>如果你最近在做 Agent，大概率已经碰过一个很现实的问题：模型本身很聪明，但一旦任务变长、工具变多、状态变复杂，它就开始“看起来会做，实际上做不稳”。</p> <p>LangChain 这篇 <a href="https://www.langchain.com/blog/how-to-build-a-custom-agent-harness">How to Build a Custom Agent Harness</a> 讲的不是又一个 Agent 炫技 demo，而是一个更底层的问题：<strong>Agent 真正的工程难点，不在模型，而在 harness</strong>。</p> <p>你可以把它理解成一句特别好记的话：</p> <blockquote> <p><code>agent = model + harness</code></p> </blockquote> <p>模型负责“想”，harness 负责“把想法变成可执行、可控制、可恢复的系统”。</p> <h2 id="目录">目录</h2> <ul> <li><a href="#%E5%85%88%E8%AF%B4%E7%BB%93%E8%AE%BA%E4%B8%BA%E4%BB%80%E4%B9%88-harness-%E6%89%8D%E6%98%AF%E6%A0%B8%E5%BF%83">先说结论：为什么 harness 才是核心</a></li> <li><a href="#%E4%BB%80%E4%B9%88%E6%98%AF-agent-harness">什么是 Agent Harness</a></li> <li><a href="#middleware-%E4%B8%BA%E4%BB%80%E4%B9%88%E6%98%AF%E5%85%B3%E9%94%AE%E6%8A%BD%E8%B1%A1">Middleware 为什么是关键抽象</a></li> <li><a href="#%E4%BB%BB%E5%8A%A1%E5%92%8C-harness-%E5%BF%85%E9%A1%BB%E5%8C%B9%E9%85%8D">任务和 Harness 必须匹配</a></li> <li><a href="#%E4%B8%80%E4%B8%AA%E6%9B%B4%E5%AE%9E%E7%94%A8%E7%9A%84%E6%9E%B6%E6%9E%84%E5%9B%BE">一个更实用的架构图</a></li> <li><a href="#%E6%80%8E%E4%B9%88%E8%87%AA%E5%B7%B1%E6%90%AD%E4%B8%80%E4%B8%AA%E5%8F%AF%E5%AE%9A%E5%88%B6%E7%9A%84-harness">怎么自己搭一个可定制的 Harness</a></li> <li><a href="#%E5%AE%9E%E6%88%98%E5%BB%BA%E8%AE%AE">实战建议</a></li> <li><a href="#%E6%80%BB%E7%BB%93">总结</a></li> </ul> <h2 id="先说结论为什么-harness-才是核心">先说结论：为什么 harness 才是核心</h2> <p>很多人做 Agent 的思路是反过来的：先挑最强模型，再往里面塞工具，最后祈祷它足够稳定。</p> <p>这条路不是完全不行，但有三个典型问题：</p> <ul> <li>任务一长，上下文很快爆掉</li> <li>工具一多，调用顺序和状态管理就开始失控</li> <li>一旦涉及审批、重试、隔离、记忆，纯 prompt 很难兜住</li> </ul> <p>LangChain 这篇文章的核心态度很明确：<strong>不要把 Agent 只看成一个模型调用循环，Agent 本质上是一套围绕模型的执行外壳</strong>。</p> <p>这个外壳要负责的事情，比你想象得多：</p> <ul> <li>给模型喂对上下文</li> <li>控制工具注册和生命周期</li> <li>管理状态、记忆和中间结果</li> <li>拦截异常和失败</li> <li>在关键点插入策略、审批和审计</li> </ul> <p>所以真正值得优化的，不是“模型再聪明一点”，而是“harness 能不能把模型放到正确的工作环境里”。</p> <h2 id="什么是-agent-harness">什么是 Agent Harness</h2> <p>原文里最重要的一句话是：<strong>harness 是围绕模型的脚手架</strong>。</p>