VoltAgent Core Reference

Reference for the VoltAgent class in @voltagent/core.

Source files:

• packages/core/src/voltagent.ts
• packages/core/src/types.ts

Options Overview

VoltAgentOptions supports:

• agents: Record of Agent instances to register.
• workflows: Record of Workflow or WorkflowChain instances.
• memory: Default Memory used for agents and workflows.
• agentMemory: Default Memory for agents (falls back to memory).
• workflowMemory: Default Memory for workflows (falls back to memory).
• toolRouting: Global ToolRoutingConfig defaults.
• triggers: VoltAgentTriggersConfig handlers.
• server: Server provider factory (for example honoServer()).
• serverless: Serverless provider factory for fetch runtimes.
• voltOpsClient: Shared VoltOpsClient instance.
• observability: VoltAgentObservability instance.
• logger: Shared Logger instance.
• mcpServers: Record of MCP servers or factories.
• a2aServers: Record of A2A servers or factories.
• checkDependencies: Set to false to skip dependency checks.

Deprecated options:

• port
• autoStart
• customEndpoints
• enableSwaggerUI

Lifecycle Notes

• Registers agents and workflows on construction.
• Auto-starts the server if a server provider is supplied.
• Applies default memory to agents and workflows.
• Auto-configures VoltOps client from VOLTAGENT_PUBLIC_KEY and VOLTAGENT_SECRET_KEY if not provided.
• Initializes MCP and A2A servers and starts MCP transports after server start.

Methods

• registerAgent(agent), registerAgents(agents)
• registerWorkflow(workflow), registerWorkflows(workflows)
• registerTrigger(name, config), registerTriggers(triggers)
• getAgent(id), getAgents(), getAgentCount()
• getWorkflow(id), getWorkflows(), getWorkflowCount()
• getObservability()
• startServer(), stopServer(), getServerInstance()
• serverless() to access the serverless provider
• shutdown() for graceful shutdown, shutdownTelemetry() for observability

Example

import { VoltAgent } from "@voltagent/core";
import { honoServer } from "@voltagent/server-hono";

const app = new VoltAgent({
  agents: { agent },
  workflows: { workflow },
  server: honoServer(),
});

await app.startServer();