VoltAgent
用 TypeScript 构建、运行并观测生产级 AI Agent 与工作流。
- Star 数
- ★ 11k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 28/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · OpenAI API · Claude API
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- TypeScript 团队要把带天气工具和持久记忆的助手作为 HTTP 服务运行时，可用 Agent、Memory、honoServer() 和 VoltAgent 组织应用。
- 不适合
- 需要完全离线、数据不出本地的团队，VoltOps 控制台与托管知识库依赖厂商云服务
- 希望零代码搭建智能体的用户，框架需要自行编写 TypeScript 代码
- 不愿自行配置模型提供商 API 密钥与记忆存储适配器的团队
这个 Agent 能做什么，适合哪些场景？
VoltAgent 是一个 AI Agent Engineering Platform，由开源 TypeScript 框架和 VoltOps Console 组成。框架以 @voltagent/core 的 Agent、Memory 和 VoltAgent 等组件定义 Agent、工具、持久记忆、模型提供商及工作流，并可通过 server-hono 启动 HTTP 服务。它支持主管 Agent 协调子 Agent、声明式多步骤工作流、MCP、RAG、语音、运行时 Guardrails 与 Evals。VoltOps Console 提供 traces、日志、仪表盘、记忆管理、提示词构建、部署、触发器、监控、Guardrails、Evals 和知识库能力；README 标注其可用 Cloud 或 Self-Hosted 方式提供。
使用 npm create voltagent-app@latest 创建项目后，可在 src/index.ts 中用 new Agent 配置 name、instructions、model、tools 和 Memory，再通过 new VoltAgent 注册 agents、workflows、honoServer() 与 logger。示例用 @ai-sdk/openai 的 openai("gpt-4o-mini") 作为模型，并以 LibSQLMemoryAdapter({ url: "file:./.voltagent/memory.db" }) 保存记忆。npm run dev 会由 tsx 编译并运行服务，示例启动地址为 http://localhost:3141；运行中的 Agent 可在 VoltOps Console 中聊天和查看执行信息。工作流可用 createWorkflowChain 定义输入、结果和 .andThen 步骤，并通过 suspend 与 resumeSchema 实现人工审批后的恢复执行。
- TypeScript 团队要把带天气工具和持久记忆的助手作为 HTTP 服务运行时，可用 Agent、Memory、honoServer() 和 VoltAgent 组织应用。
- 需要经理审批高金额报销的业务团队，可参考 expenseApprovalWorkflow 的 suspend/resumeSchema 流程构建可恢复的人机协作工作流。
- 要让多个专职 Agent 在主管协调下完成研究或复杂任务的开发者，可采用 Supervisors & Sub-Agents 运行模式。
- 需要把内部资料检索后再生成回答的应用团队，可接入 retriever agents 或 VoltAgent Knowledge Base 的文档摄取、切分、嵌入和搜索能力。
- 需要排查线上 Agent 或工作流执行问题的工程团队，可在 VoltOps Console 查看 traces、日志、性能指标和仪表盘。
- 希望把 VoltAgent 文档、示例和变更日志提供给 Claude、Cursor 或 Windsurf 编程助手的团队，可使用 @voltagent/mcp-docs-server。
如何安装或部署这个 Agent？
执行：
npm create voltagent-app@latest该命令会引导完成项目设置。README 未说明 Node.js 版本、模型提供商 API 密钥或 VoltOps 凭证的具体配置方式；若使用示例中的 openai("gpt-4o-mini")，需自行具备可用的 OpenAI 模型访问配置。
如何使用这个 Agent？
进入创建后的项目并执行：
npm run dev生成的 src/index.ts 会注册 Agent 和 src/workflows/index.ts 中的 expenseApprovalWorkflow。服务启动后，README 示例显示 HTTP 地址为 http://localhost:3141；可在 VoltOps Console 中选择项目、打开 Agent 详情进行聊天，或在 Workflows 页面运行 “Expense Approval Workflow”。该工作流的小额示例输入为 {"employeeId":"EMP-123","amount":250,"category":"office-supplies","description":"New laptop mouse and keyboard"}。
这个 Agent 有哪些优点和局限？
- 核心 API 将 Agent、工具、记忆、模型、工作流和服务器注册集中在 @voltagent/core 的统一运行时中。
- createWorkflowChain 提供 Zod 输入/结果模式、链式步骤及 suspend/resumeSchema，适合需要人工介入的可恢复流程。
- README 明确提供 OpenAI、Anthropic、Google 等模型提供商切换路径，并支持 MCP、RAG、语音、Guardrails 和 Evals。
- VoltOps Console 将聊天测试、执行 traces、日志、记忆检查、监控和部署相关功能放在同一平台侧。
- README 未给出 Node.js 版本、环境变量名称、API 密钥配置或完整生产部署命令，落地前需补齐运行环境细节。
- 示例直接依赖 @ai-sdk/openai、@voltagent/libsql、@voltagent/logger 和 @voltagent/server-hono；实际项目需要选择并配置相应包与模型提供商。
- VoltOps 的 Cloud 与 Self-Hosted 均被提及，但 README 没有说明定价、资源要求、数据保留或自托管操作步骤。
- Agent 的网络、工具权限、MCP 服务器权限和 Guardrails 策略由应用配置决定，README 未提供默认安全边界或失败处理承诺。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| VoltAgent 当前 | 28 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 11k | 1 天前 | TypeScript | ChatGPT · OpenAI API · Claude API |
| Kite 智能体框架 | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 11 | 4 个月前 | Python | OpenAI API · Claude API |
| 从原型到生产的生成式AI代理实战指南 | 证据不足 | 代码库 / SDK免费 + 模型费 | ★ 22k | 4 天前 | Jupyter Notebook | — |
| AgentScope 2.0 | 70 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 35k | 2 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库包含安全策略（SECURITY.md）和依赖管理工具（syncpack），但未发现权限最小化、用户确认、数据流透明、敏感数据处理、外部影响、回滚或来源归属的具体实现或文档。因此这些标准得分为0。
自一致性：README和package.json中的包名、描述和脚本基本一致，但存在一些不一致（如README中提到的@voltagent/mcp-docs-server在package.json中未明确列出）。依赖可用性：package.json列出了大量依赖，但未提供锁文件或依赖来源验证。失败消息：未发现错误处理或用户友好的失败消息文档。
受众和场景：README明确面向开发者，提供了快速入门和多种示例。能力边界：文档列出了多种功能，但未明确说明限制。触发精度：工作流示例展示了触发机制，但未详细说明。环境适配：要求Node>=20和pnpm>=8，但未说明其他环境要求。
信息架构：README结构清晰，有目录和链接。安装说明：提供了npm create voltagent-app命令。命名稳定性：包名和版本号存在，但未说明命名约定。示例和FAQ：提供了多个示例，但无FAQ。已知限制：未提及。许可证：MIT许可证明确。版本变更日志：有changesets配置，但未提供实际变更日志。维护责任：未明确说明维护者或贡献指南。
输出可用性：示例代码展示了如何使用，但未提供输出格式说明。边际价值：提供了丰富的功能，但未与其他框架对比。成本效益：未提供性能或成本数据。
声明可追溯性：README中的功能声明未链接到具体代码或测试。跨来源佐证：未提供外部验证。事实与推断分离：文档中未明确区分事实和推断。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库未提供锁文件，依赖版本可能不稳定。
- README中提到的某些包（如@voltagent/mcp-docs-server）在package.json中未明确列出，可能导致安装问题。
- 未提供已知限制或安全注意事项，用户可能低估风险。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Patch Changes - [#1481](https://github.com/VoltAgent/voltagent/pull/1481) [e481624](https://github.com/VoltAgent/voltagent/commit/e4816249bf0843680ad4200cc33ea077ffcbd116) Thanks [@Arnavkar](https://github.com/Arnavkar)! - fix(core): upgrade the Amazon Bedrock and Google Vertex providers to their AI SDK v6 releases @ai-sdk/amazon-bedrock and @ai-sdk/google-vertex move from 3.x to ^4.0.0. These upgrades move both providers from @ai-sdk/provider-utils@3 to @ai-sdk/provider-utils@4, aligning them with core's AI SDK v6 dependencies. …在 GitHub 查看 ↗ -
发布说明摘录
Minor Changes - [#1423](https://github.com/VoltAgent/voltagent/pull/1423) [316538a](https://github.com/VoltAgent/voltagent/commit/316538a96860ee675931bbbf4f9dd1f6dec3937e) Thanks [@jiangjiang248](https://github.com/jiangjiang248)! - Allow custom workspace sandboxes to receive the original execute_command command and args by disabling toolkit command normalization. Fixes #1422.在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - [#1350](https://github.com/VoltAgent/voltagent/pull/1350) [80827c3](https://github.com/VoltAgent/voltagent/commit/80827c3f0550fdc3bb608aaef53d71b45551e585) Thanks [@nuthalapativarun](https://github.com/nuthalapativarun)! - Add README documentation在 GitHub 查看 ↗