> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# VoltAgent

> 在 VoltAgent 智能体中使用 TokenLab 模型

## 概述

VoltAgent 直接支持 AI SDK 语言模型。配置一个兼容 OpenAI 的 AI SDK 提供程序，并将 TokenLab 的 `/v1` 基础 URL 传入，即可将所选模型应用于您的智能体。

<Note>
  **类型**: TypeScript 智能体框架

  **主要路径**: 通过 AI SDK 使用兼容 OpenAI 的 Chat Completions

  **支持置信度**: 支持兼容 OpenAI 的路径
</Note>

## 环境配置

```bash theme={null}
export TOKENLAB_API_KEY="sk-your-tokenlab-key"
```

## 直接使用 AI SDK 提供程序

```ts theme={null}
import { Agent } from "@voltagent/core";
import { createOpenAI } from "@ai-sdk/openai";

const tokenlab = createOpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: "https://api.tokenlab.sh/v1",
});

const agent = new Agent({
  name: "tokenlab-agent",
  instructions: "Answer concisely.",
  model: tokenlab("claude-sonnet-5"),
});
```

## 模型路由路径

如果您的 VoltAgent 注册表快照包含来自 `models.dev` 的 TokenLab 提供程序条目，请配置：

```bash theme={null}
export TOKENLAB_API_KEY="sk-your-tokenlab-key"
export TOKENLAB_BASE_URL="https://api.tokenlab.sh/v1"
```

然后使用注册表模型字符串，例如 `tokenlab/claude-sonnet-5`。

## 端点说明

直接使用 AI SDK 路径是最明确的设置方式。仅当您选择的 AI SDK 提供程序/客户端配置为相应协议时，才使用 TokenLab 原生 Responses、Anthropic Messages 或 Gemini 端点。