5、自定义中间件

某些复杂场景下，官方内置的中间件不能完全满足需求，此时可以通过实现LangChain暴露的中间件hook函数构建自定义中间件。
说明：尽可能使用内置中间件。

5.1 什么是hook函数(钩子函数)

Hook 函数，中文常叫钩子函数，指的是：在某个既定流程的特定时机，被框架、系统或主程序自动调用的扩展函数。

因此，可以把它理解成：
主流程预留了一些插槽，允许你在这些位置挂上自己的函数，这种被挂进去并在特定时机执行的函数，就是 hook 函数。

核心特点：
1、不是你主动在业务代码里随便调用的，而是当流程运行到某个“钩子点”时，系统自动触发它。
2、它依附于一个更大的执行流程。比如“请求开始前”“模型调用前”“任务结束后”“异常发生时”等。
3、它的作用是让你在不改主流程源码的前提下插入自己的逻辑。例如做日志、鉴权、修改输入、
拦截输出、清理资源等。
LangChain的中间件作用在Agent架构中，后者是基于LangGraph构建的流程图。如下列出了六个hook函数（钩子函数）：

无论是官方内置中间件、自定义中间件、还是下文提到的便捷装饰器中间件，通常都是通过实现其中的一个或多个hook来生效的。

5.2 LangChain的hook函数分类

官方将六个钩子函数按照风格分为两类
类型1：Node-style hooks(节点风格钩子)
顾名思义，它们在流程的特定节点运行。
适合顺序逻辑，如记录日志、验证
包括

• before_agent：在Agent开始运行之前执行。
• before_model：在模型调用之前执行。
• after_model：在模型调用之后执行。
• after_agent：在Agent流程全部完成后执行。

类型2：Wrap-style hooks(包装风格钩子)
顾名思义，它们在模型或工具调用前后运行。
适合控制流，如重试、回退、缓存。
包括

• wrap_model_call (包裹模型调用)
• wrap_tool_call (包裹工具调用)