第九章：Middleware 深度实战 —— 构建可扩展的 Agent 增强层

9.1 引言：为什么 Agent 需要 Middleware在前几章中，我们构建了能够调用工具、执行多步推理的 Agent。然而，生产环境中的 Agent 面临着更复杂的挑战：模型调用可能因网络波动失败、长对话会耗尽上下文窗口、敏感数据可能泄露给模型、高风险操作需要人工审批。这些横切关注点（Cross-Cutting Concerns）如果直接嵌入 Agent 主逻辑，会导致代码耦合严重、难以维护。LangChain v1 引入了Middleware 系统，采用经典的中间件模式，允许开发者在 Agent 执行的关键节点（模型调用前后、工具调用前后、Agent 启动/结束）插入可组合的拦截逻辑。本章将从源码层面深入解析：架构设计：AgentMiddleware基类、ModelRequest/ModelResponse数据模型、6 大生命周期钩子内置中间件全览：14 个开箱即用的中间件，覆盖容错、安全、监控、增强四大类场景自定义中间件开发：通过类继承和装饰器两种方式创建中间件组合模式：中间件栈的执行顺序、右到左合成算法、最佳实践9.2 Middleware 架构总览