1
Introduction: Build AI Agents That Actually Work

Learn to create production-ready AI agents with tools, memory, and real-world integrations. No fluff, just working code.

Watch This Step Video

Why Do You Need VoltAgent?

Building AI agents from scratch is like building a web app without React or Express. You'll spend months writing boilerplate instead of focusing on your actual business logic.

Without a Framework

Manual API calls to OpenAI/Claude
Custom conversation state management
Manual tool integration and execution
No debugging, monitoring, or observability
Complex agent coordination logic

With VoltAgent

Unified API for all LLM providers
Built-in conversation memory
Tool system with automatic execution
VoltOps: Real-time debugging & monitoring
Multi-agent coordination out of the box

What is VoltAgent?

VoltAgent is a TypeScript-first framework for building AI agents. Think of it as the "Express.js for AI agents" - it handles the plumbing so you can focus on building.

Core Philosophy

Modular:Use only what you need
Developer-First:Made for how developers actually work
Production-Ready:Monitoring, scaling, and deployment built-in

Getting Started in 60 Seconds

Create a new VoltAgent project and have a working AI agent in under a minute:

Step-by-Step Setup

1

Create Your Project

npm create voltagent-app@latest
2

Navigate to Project

cd my-voltagent-app
3

Add Your API Key

Create or edit the .env file and add your OpenAI API key:

OPENAI_API_KEY=your-api-key-here

Get your API key from OpenAI Platform

4

Start Your Agent

npm run dev

Success! Your agent is running

You should see this in your terminal:

══════════════════════════════════════════════════
  VOLTAGENT SERVER STARTED SUCCESSFULLY
══════════════════════════════════════════════════
  ✓ HTTP Server: http://localhost:3141

  VoltOps Platform:    https://console.voltagent.dev
══════════════════════════════════════════════════
[VoltAgent] All packages are up to date

Visit console.voltagent.dev to find your agent and start chatting:

VoltOps Dashboard Demo - How to find your agent and start chatting

The code below shows exactly what you just created.

Your Agent Code

This is what gets generated for you. Hover over the explanations to see how each part works.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import { VoltAgent, Agent } from "@voltagent/core";
import { VercelAIProvider } from "@voltagent/vercel-ai";
import { openai } from "@ai-sdk/openai";

// Define a simple agent
const agent = new Agent({
name: "my-agent",
instructions: "A helpful assistant that answers questions without using tools",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
});

// Initialize VoltAgent with your agent(s)
new VoltAgent({
agents: { agent },
});



// Your agent is now running!
// Visit console.voltagent.dev to interact
"I need an AI agent"
The Agent class is your AI's personality container. It defines who your AI is and how it should behave.
"What to call it?"
Give it a descriptive name. Think of it like naming a function - choose something that tells you what this agent does.
"How should it behave?"
Instructions define your agent's personality and behavior. The LLM provider handles the AI communication layer.
"Which AI to use?"
Choose your AI model like a database. gpt-4o-mini is fast and cheap, gpt-4 is more powerful for complex reasoning.
"How to make it accessible?"
VoltAgent is your server - like Express.js but for AI agents. Handles HTTP, WebSocket, and connects to VoltOps.

The Result

In just 15 lines of code, you've created a production-ready AI agent with monitoring, debugging, and a web interface. That's the power of VoltAgent - less boilerplate, more building.

Meet VoltOps: Your Agent Console

VoltOps is your agent's dashboard. When you start your agent, it automatically connects toconsole.voltagent.dev where you can chat with it in real-time.

What You'll See

Real-time chat interface
Agent performance metrics
Conversation logs and debugging
Live code updates

Your Learning Journey

We'll build your agent step by step, each tutorial adding one crucial capability:

1

The Chatbot Problem

Why simple chatbots fail and what makes AI agents different. Learn the fundamental concepts before diving into code.

2

Tools: Give Your Agent Superpowers

Create custom tools that let your agent actually do things: send emails, manage databases, call APIs, and more.

3

Memory: Remember Every Conversation

Add persistent memory so your agent remembers users, past conversations, and builds context over time.

4

MCP: Connect to Everything

Use Model Context Protocol to connect your agent to GitHub, Slack, databases, and any external system you need.

5

Subagents: Build Agent Teams

Create specialized agents that work together to handle complex workflows and enterprise use cases.

What You Need to Know

This tutorial assumes basic familiarity with:

Required

Basic TypeScript/JavaScript
Node.js and npm
Understanding of APIs

Helpful (But Not Required)

Experience with AI/LLMs
Database knowledge
DevOps experience

Ready to Build AI Agents?

Transform from chatbot builder to AI agent architect in just 5 tutorials. Let's build something amazing together.

Start Tutorial Journey →
4 more steps remaining • 15 minutes • Production-ready agents