Using Models with Agents

VoltAgent 1.x has no llm provider prop. Set model to either:

• An ai-sdk LanguageModel (imported from a provider package), or
• A model string like openai/gpt-4o-mini resolved by the built-in model router.

Quick Example

import { Agent } from "@voltagent/core";

const agent = new Agent({
  name: "my-agent",
  instructions: "Helpful and concise",
  model: "anthropic/claude-3-5-sonnet",
});

const res = await agent.generateText("Say hi", { temperature: 0.2 });
console.log(res.text);

You can also pass a LanguageModel directly:

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

const agent = new Agent({
  name: "my-agent",
  instructions: "Helpful and concise",
  model: anthropic("claude-3-5-sonnet"),
});

Provider Options (IntelliSense)

Use providerOptions for provider-specific settings in generateText, streamText, generateObject, and streamObject calls.

await agent.generateText("Draft a summary", {
  temperature: 0.3,
  maxOutputTokens: 300,
  providerOptions: {
    openai: {
      reasoningEffort: "medium",
      textVerbosity: "low",
    },
    anthropic: {
      sendReasoning: true,
      cacheControl: { type: "ephemeral" },
    },
    google: {
      thinkingConfig: {
        thinkingBudget: 1024,
      },
    },
    xai: {
      reasoningEffort: "medium",
    },
  },
});

TypeScript IntelliSense is available for openai, anthropic, google, and xai option objects.

Provider Selection

Use any ai-sdk provider package you have configured (OpenAI, Anthropic, Google, Groq, Mistral, Vertex, Bedrock, etc.), or use model strings. For installation and an up-to-date model matrix, see:

Providers & Models

For how model strings are resolved and how environment variables map, see:

Model Router & Registry

Retries and Fallbacks

For retry counts and fallback lists, see:

Retries and Fallbacks