VoltAgent
用 TypeScript 构建、运行并观测生产级 AI 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中的功能声明未链接到具体代码或测试。跨来源佐证：未提供外部验证。事实与推断分离：文档中未明确区分事实和推断。
- 仓库未提供锁文件，依赖版本可能不稳定。
- README中提到的某些包（如@voltagent/mcp-docs-server）在package.json中未明确列出，可能导致安装问题。
- 未提供已知限制或安全注意事项，用户可能低估风险。
这个 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 有哪些优点和局限？
- 核心 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？
执行：
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"}。