如何添加自定义中间件

在 LangGraph 平台上部署智能体时，您可以向服务器添加自定义中间件，以处理日志记录请求指标、注入或检查头部信息以及实施安全策略等跨领域问题，而无需修改核心服务器逻辑。这与添加自定义路由的方式相同 - 您只需提供自己的 Hono 应用。

添加中间件使您能够在整个部署中全局拦截和修改请求，无论这些请求是访问您的自定义端点还是内置的 LangGraph 平台 API。

仅针对内置 LangGraph 平台 API 的请求

目前仅支持拦截和修改请求。

您仍然可以向响应添加自定义头部信息，但目前尚不支持修改内置 LangGraph 平台端点的响应头部信息或响应体。

创建应用

从一个现有的 LangGraph 平台应用开始，将以下中间件代码添加到您的 app.ts 文件中。如果您是重新开始，可以使用 CLI 从模板创建新的应用。

npm create langgraph

确保将 hono 作为依赖项安装。

npm install hono

拥有 LangGraph 项目后，添加以下应用代码

import { Hono } from "hono";

export const app = new Hono();

app.use(async (c, next) => {
  c.header("X-Custom-Header", "Hello World");
  await next();
});

配置 langgraph.json

将以下内容添加到您的 langgraph.json 文件中。确保路径指向您上面创建的 app.py 文件。

{
  "graphs": {
    "agent": "./src/agent/graph.ts:graph"
  },
  "env": ".env",
  "http": {
    "app": "./src/agent/app.ts:app"
  }
  // Other configuration options like auth, store, etc.
}

启动服务器

在本地测试服务器

npx langgraph-cli@latest dev --no-browser

现在，对您服务器的任何请求的响应都将包含自定义头部 X-Custom-Header。

部署

您可以将此应用原样部署到托管的 LangGraph Cloud 或您自托管的平台。

下一步

现在您已经向部署添加了自定义中间件，可以使用类似的技术添加自定义路由。