VoltAgent：AI Agent 工程平台

English | 繁體中文 | 简体中文 | 日本語 | 한국어

官网首页 | 文档 | 示例

⭐ 如果你喜欢我们的项目，请点个 Star ⬆️

VoltAgent 是一个端到端的 AI Agent 工程平台，主要由两部分组成：

• 开源 TypeScript 框架 – 涵盖内存、RAG、Guardrails（防护栏）、工具、MCP、语音、工作流等功能。
• VoltOps 控制台 云端版 自托管版 – 提供可观测性、自动化、部署、评估（Evals）、Guardrails、Prompt 管理等功能。

VoltAgent 让你能够完全掌控代码，并以生产环境就绪的可见性和运维能力交付 AI Agent。

核心 TypeScript 框架

借助该开源框架，你可以构建具备记忆、工具调用和多步工作流的智能 Agent，并连接到任何 AI 模型提供商。你可以创建复杂的“多 Agent 系统”，让各领域专家 Agent 在 Supervisor（主管）的协调下协同工作。

• Core Runtime (@voltagent/core): 在同一处定义具有类型化角色、工具、内存和模型提供商的 Agent，保持代码整洁有序。
• 工作流引擎 (Workflow Engine): 以声明式方式描述多步自动化，无需拼接复杂的自定义控制流。
• 主管与子 Agent (Supervisors & Sub-Agents): 在主管运行时下运行一组专业 Agent，由其负责任务路由并保持同步。
• 工具注册表 (Tool Registry) & MCP: 交付带有生命周期钩子和取消功能的 Zod 类型化工具，并无需额外的胶水代码即可连接 Model Context Protocol 服务器。
• LLM 兼容性: 只需更改配置即可在 OpenAI、Anthropic、Google 或其他提供商之间切换，无需重写 Agent 逻辑。
• 内存 (Memory): 挂载持久化内存适配器，使 Agent 能够在多次运行中记忆重要上下文。
• 可恢复流式传输 (Resumable Streaming): 允许客户端在刷新页面后重新连接到正在进行的流，并继续接收相同的响应。
• 检索与 RAG (Retrieval & RAG): 接入检索器 Agent，在模型回答前从数据源提取事实并提供背景依据（RAG）。
• VoltAgent 知识库: 使用托管的 RAG 服务进行文档摄入、分块、向量化（Embeddings）和搜索。
• 语音 (Voice): 通过 OpenAI、ElevenLabs 或自定义语音提供商添加语音转文字（STT）和文字转语音（TTS）功能。
• Guardrails: 在运行时拦截并验证 Agent 的输入或输出，以强制执行内容策略和安全规则。
• 评估 (Evals): 在工作流中运行 Agent 评估套件，以衡量并改进 Agent 的表现。

MCP Server (@voltagent/mcp-docs-server)

你可以使用 MCP 服务器 @voltagent/mcp-docs-server 让你的 LLM 学习如何使用 VoltAgent，适用于 Claude、Cursor 或 Windsurf 等 AI 编码助手。这使得 AI 助手在编写代码时能够直接访问 VoltAgent 的文档、示例和更新日志。

📖 如何设置 MCP 文档服务器

⚡ 快速上手

使用 create-voltagent-app CLI 工具在几秒钟内创建一个新的 VoltAgent 项目：

npm create voltagent-app@latest

该命令将引导你完成设置。

你可以在 src/index.ts 中看到入门代码，它现在注册了一个 Agent 以及 src/workflows/index.ts 中提供的完整工作流示例。

import { VoltAgent, Agent, Memory } from "@voltagent/core";
import { LibSQLMemoryAdapter } from "@voltagent/libsql";