# Voltagent Core Reference

> Reference for the VoltAgent class: constructor options, lifecycle methods, and runtime behavior.

Reference for the VoltAgent class: constructor options, lifecycle methods, and runtime behavior.

- Page: https://ss33.ai/skills/voltagent/voltagent-core-reference-70836639901
- Publisher: voltagent
- Category: [AI & Agents](https://ss33.ai/skills/category/ai-and-agents-y6jz7i) › [Misc](https://ss33.ai/skills/category/ai-and-agents-y6jz7i/misc-ik6ov9)
- License: MIT
- Source: https://github.com/voltagent/skills/blob/066b137c520a8739a899e160516d1f4044add7f3/skills/voltagent-core-reference/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/voltagent/voltagent-core-reference-70836639901

# 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

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

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

await app.startServer();
```