VoltAgent — TypeScript AI Agent Framework

VoltAgent — Complete Feature Guide

Architecture Overview

VoltAgent consists of two main components:

1. Open-Source Framework (@voltagent/core) — The agent runtime
2. VoltOps Console (Cloud & Self-Hosted) — Observability dashboard

Core Framework Features

Agent Definition

import { Agent } from "@voltagent/core";
import { openai } from "@ai-sdk/openai";

const agent = new Agent({
  name: "my-agent",
  instructions: "A helpful assistant",
  model: openai("gpt-4o-mini"),
});

Typed Tools with Zod

import { createTool } from "@voltagent/core";
import { z } from "zod";

const weatherTool = createTool({
  name: "get_weather",
  description: "Get current weather for a city",
  parameters: z.object({ city: z.string() }),
  execute: async ({ city }) => {
    // Your weather API logic
    return { temp: 72, condition: "sunny" };
  },
});

Memory System

Attach durable memory adapters (LibSQL, SQLite, custom) for persistent context across agent runs. Each conversation maintains full history and can be resumed.

Multi-Agent Orchestration

const supervisor = new Agent({
  name: "supervisor",
  subAgents: [researchAgent, writerAgent, reviewerAgent],
  instructions: "Coordinate the team to produce high-quality content",
});

Workflow Engine

Declare multi-step automations with suspend/resume capabilities. Workflows can pause, wait for external input, and continue execution.

RAG & Retrieval

Plug in retriever agents for fact-grounding before responses. Supports any vector database or document source.

Guardrails

Intercept and validate agent input/output at runtime — content filtering, format validation, safety checks.

Voice Support

Add text-to-speech and speech-to-text capabilities to your agents.

MCP Integration

Connect to any MCP server as a tool source. VoltAgent also provides @voltagent/mcp-docs-server for teaching LLMs how to use the framework.

VoltOps Console

The built-in observability dashboard provides:

• Real-time tracing — See every tool call, LLM request, and agent decision
• Memory management — Browse and edit agent memory
• Performance metrics — Token usage, latency, error rates
• Deployment — Deploy agents to production
• Evals — Run evaluation suites to measure agent behavior

Packages

FAQ

Q: What is VoltAgent? A: An open-source TypeScript framework for building AI agents with built-in memory, RAG, guardrails, multi-agent orchestration, and an observability console. It supports OpenAI, Anthropic, Google, and any AI SDK provider.

Q: Is VoltAgent free? A: The framework is fully open-source under MIT license. VoltOps Console has both free self-hosted and cloud options.

Q: How is VoltAgent different from LangChain or CrewAI? A: VoltAgent is TypeScript-first (vs Python), has built-in observability (VoltOps Console), and uses Zod for type-safe tool definitions. It's designed for production use with streaming, resume, and deployment features.