VoltAgent 是一个端到端的 AI 智能体工程平台,由两个主要部分组成:开源 TypeScript 框架,以及 VoltOps Console 云/自托管控制台。其目标是让开发者以完整的代码控制构建智能体,并以生产就绪的可见性和运维能力将其发布上线。
一、核心 TypeScript 框架 使用开源框架,可以构建具备记忆、工具和多步骤工作流的智能体,并连接任意 AI 提供商。可以创建复杂的多智能体系统,让专门化的智能体在监督者协调下协同工作。
主要能力包括:
- 核心运行时(@voltagent/core):在一处定义具有类型化角色、工具、记忆和模型提供商的智能体,保持结构清晰。
- 工作流引擎:以声明式方式描述多步骤自动化,而无需自行拼接自定义控制流。
- 监督者与子智能体:在监督者运行时下运行专门化智能体团队,由监督者路由任务并保持同步。
- 工具注册表与 MCP:发布带 Zod 类型、具备生命周期钩子和取消能力的工具,并连接 Model Context Protocol 服务器,无需额外胶水代码。
- LLM 兼容性:通过更改配置在 OpenAI、Anthropic、Google 或其他提供商之间切换,而无需重写智能体逻辑。
- 记忆:挂载持久化记忆适配器,使智能体在多次运行之间记住重要上下文。
- 可恢复流式传输:让客户端在刷新后重新连接到进行中的流,并继续接收同一响应。
- 检索与 RAG:接入检索智能体,从数据源拉取事实并在模型回答前进行基于事实的增强(RAG)。
- VoltAgent 知识库:使用托管 RAG 服务进行文档摄取、分块、嵌入和搜索。
- 语音:通过 OpenAI、ElevenLabs 或自定义语音提供商添加文本转语音和语音转文本能力。
- 护栏:在运行时拦截并验证智能体输入或输出,以执行内容策略和安全规则。
- 评估:在工作流旁运行智能体评估套件,以衡量并改进智能体行为。
此外,可使用 MCP 服务器 @voltagent/mcp-docs-server 教会 LLM 如何使用 VoltAgent,适用于 Claude、Cursor 或 Windsurf 等 AI 编程助手。这使 AI 助手在编码时可直接访问 VoltAgent 文档、示例和变更日志。
二、使用方式 可通过 create-voltagent-app CLI 工具在数秒内创建新的 VoltAgent 项目,该命令会引导完成设置。启动代码位于 src/index.ts,其中注册了一个智能体以及位于 src/workflows/index.ts 的完整工作流示例。随后进入项目并运行开发命令,tsx 会编译并运行代码,终端会显示 VoltAgent 服务器启动消息。
与智能体交互的步骤:打开控制台(点击终端输出中的 VoltOps LLM Observability Platform 链接,或复制粘贴到浏览器);在 VoltOps LLM Observability Platform 页面找到列出的智能体(例如 "my-agent");点击智能体名称打开详情;在详情页点击右下角聊天图标打开聊天窗口;输入如 "Hello" 的消息并按回车。
运行第一个工作流:新项目还包含一个强大的工作流引擎。费用审批工作流演示了带挂起/恢复能力的人在环自动化。可直接从 VoltOps 控制台测试预置的 expenseApprovalWorkflow:启动服务器后进入 Workflows 页面;使用项目选择器选择项目(例如 "my-agent-app");找到 "Expense Approval Workflow" 并点击,然后点击 "Run" 按钮;提供输入,工作流期望一个包含费用详情的 JSON 对象,可尝试小额费用以自动批准:{ "employeeId" : " EMP-123 " , "amount" : 250 , "category" : " office-supplies " , "description" : " New laptop mouse and keyboard " };执行后可检查每一步的详细日志,并直接在控制台查看最终输出。
更多示例可访问示例仓库,包括:Airtable Agent(响应新记录并通过 VoltOps actions 将更新写回 Airtable)、Slack Agent(响应频道消息并通过 VoltOps Slack actions 回复)、ChatGPT App With VoltAgent(通过 MCP 部署 VoltAgent 并连接到 ChatGPT Apps)、WhatsApp Order Agent(构建通过自然对话处理食品订单的 WhatsApp 聊天机器人)、YouTube to Blog Agent(使用带 MCP 工具的监督者智能体将 YouTube 视频转换为 Markdown 博客文章)、AI Ads Generator Agent(使用 BrowserBase Stagehand 和 Google Gemini AI 生成 Instagram 广告)、AI Recipe Generator Agent(根据食材和偏好创建个性化烹饪建议)、AI Research Assistant Agent(用于生成综合报告的多智能体研究工作流)。
三、VoltOps Console:LLM 可观测性、自动化、部署 VoltOps Console 是 VoltAgent 的平台侧,提供可观测性、自动化和部署,以便通过实时执行追踪、性能指标和可视化仪表盘在生产环境中监控和调试智能体。
可观测性与追踪:通过详细追踪和性能指标深入查看智能体执行流程;全面概览所有智能体、工作流和系统性能指标;跟踪每次智能体交互和工作流步骤的详细执行日志。
记忆管理:检查和管理智能体记忆、上下文和对话历史;分析完整执行追踪以理解智能体行为并优化性能;在控制台中直接设计、测试和优化提示词;通过一键 GitHub 集成和托管基础设施将智能体部署到生产环境。
触发器与动作:通过 webhook、计划和自定义触发器自动化智能体工作流,以响应外部事件;监控整个系统中智能体的健康状态、性能指标和资源使用情况;设置安全边界和内容过滤器,确保智能体在定义参数内运行;运行评估套件,针对基准测试智能体行为、准确性和性能。
RAG(知识库):通过内置的检索增强生成能力将智能体连接到知识源。
四、学习资源 可从交互式教程开始学习构建 AI 智能体的基础知识;文档提供指南、概念和教程;示例展示实际实现;博客提供技术见解和最佳实践。项目欢迎贡献,可加入 Discord 服务器提问和讨论。VoltAgent 采用 MIT 许可证,Copyright © 2026-present VoltAgent。
五、限制与说明 资料未提供具体收费、价格、平台支持范围、性能效果等细节,暂未提供。