B4.run Agent Framework

这个 Agent 能做什么，适合哪些场景？

B4.run 是围绕 LangGraph.js 构建的 TypeScript 框架，为智能体和工作流提供文件系统路由、生成类型、本地开发与测试约定及持久化原语。开发者在路由的 `src/app/**/index.ts` 中定义 `agent`、`workflow`、`graph` 或 `chain`，并可配置共享工具、路由级工具和运行策略。测试可通过固定响应夹具离线回放；状态默认由 SQLite 支持，具体行为取决于应用根目录和数据库文件是否持久保存。默认构建会输出可运行的 Node 服务器、Dockerfile 和 LangSmith graph artifacts。它需要 Node.js 和 LangGraph.js；B4.run 不托管应用、不配置基础设施，也不管理密钥。

使用 npm create b4-app@latest 创建 TypeScript 项目，在路由的 index.ts 导出 agent() 或其他受支持入口，B4.run 据此发现路由并生成路由、参数、状态和工具声明。把共享工具放在 src/tools/，或将工具放在路由目录中，再通过 tools.deny 限制工具、用 tools.approve 要求人工批准；权限可限制工作区外的 shell 命令和文件路径，选择启用的 sandbox 可隔离工作区工具。运行 b4 dev 开发并用固定夹具执行离线测试；构建时可生成 Node 服务器、Dockerfile 和 LangSmith graph artifacts。部署方需要自行验证目标环境的运行时、存储、认证和模型提供方边界。

1. 希望把现有 LangGraph.js 图逐步接入应用路由的 TypeScript 团队，可将其作为 raw graph route 并逐个验证 checkpointer 行为。
2. 需要在本地确定性测试智能体的开发团队，可用固定响应夹具回放交互，并让未匹配的交互直接失败。
3. 构建需要限制工具权限的智能体的团队，可在路由中禁用工具、要求人工批准，并为工作区外操作设置权限。
4. 需要在开发服务器重启后保留状态的应用，可使用默认 SQLite 存储，并确保应用根目录和 SQLite 文件持续存在。
5. 需要生成可部署 Node 服务的 TypeScript 项目，可从默认构建获得服务器和 Dockerfile，再自行选择并验证部署环境。

如何安装或部署这个 Agent？

需要 Node.js 24 或更高版本和 npm 11。创建并安装入门项目：

npm create b4-app@latest my-agent
cd my-agent
npm install
npm test

入门测试使用夹具离线运行，无需 API 密钥或模型调用。若要运行 README 中的 OpenAI 实时 navlog 示例，需在 server/.env 中设置 OPENAI_API_KEY。

如何使用这个 Agent？

在路由文件中定义智能体，例如：

import { agent } from "@b4run/sdk"

export default agent({
  model: "gpt-5-mini",
  recursionLimit: 100,
  description: "A VFR flight planner for a Cessna 172N…",
  tools: { deny: ["runBash"], approve: [{ tool: "fileFlightPlan", allowAlways: false }] },
  systemPrompt: "You are a VFR flight-planning assistant for a Cessna 172N…",
})

使用 npm run dev 启动基本入门应用；设置 OPENAI_API_KEY 后可运行实时模型路径。navlog 模板使用两个工作区包，可分别启动服务器和 Workbench：

npm run dev:server
npm run dev:web

navlog 服务器监听 3002 端口，Workbench 监听 3010 端口。生产构建与启动命令为：

npm run build
npm start

模型服务凭据因提供方而异；README 也说明本地 Ollama 路由不需要提供方密钥。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题