AI SDK: разработка AI-приложений на TypeScript с единым API

Проект AI SDK представляет собой набор инструментов на TypeScript, который позволяет создавать приложения и агентов с поддержкой искусственного интеллекта. Он не привязан к конкретным провайдерам и работает с популярными UI-фреймворками, такими как Next.js, React, Svelte, Vue, Angular, а также с окружениями, включая Node.js.

Основная цель AI SDK — упростить интеграцию различных AI-моделей в приложения, предоставляя единый API для взаимодействия с несколькими провайдерами, такими как OpenAI, Anthropic и Google. Проект поддерживает конструкцию, в которой ты можешь использовать как стандартный API, так и SDK конкретных провайдеров.

Установка

Для начала тебе понадобится установленный Node.js версии 22 или выше, а также npm или другой менеджер пакетов. Установить AI SDK можно следующей командой:

npm install ai

Если ты используешь кодирующих агентов, таких как Claude Code или Cursor, рекомендуется добавить AI SDK в свой проект:

npx skills add vercel/ai

Архитектура

AI SDK предоставляет единый API для работы с различными моделями. По умолчанию SDK использует Vercel AI Gateway, что позволяет легко получать доступ ко всем основным провайдерам. Например, для генерации текста ты можешь использовать следующий код:

const result = await generateText({
  model: 'anthropic/claude-opus-4.6', // или 'openai/gpt-5.4', 'google/gemini-3-flash' и т.д.
  prompt: 'Hello!',
});

Также можно напрямую подключаться к провайдерам, используя их SDK:

npm install @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google

Применение

AI SDK позволяет генерировать текст, структурированные данные и использовать агентов. Например, вот как генерировать текст:

import { generateText } from 'ai';

const { text } = await generateText({
  model: 'openai/gpt-5.4',
  prompt: 'What is an agent?',
});

Чтобы генерировать структурированные данные, пример выглядит так:

import { generateText, Output } from 'ai';
import { z } from 'zod';

const { output } = await generateText({
  model: 'openai/gpt-5.4',
  output: Output.object({
    schema: z.object({
      recipe: z.object({
        name: z.string(),
        ingredients: z.array(
          z.object({ name: z.string(), amount: z.string() }),
        ),
        steps: z.array(z.string()),
      }),
    }),
  }),
  prompt: 'Generate a lasagna recipe.',
});

AI SDK также поддерживает создание агентов:

import { ToolLoopAgent } from 'ai';

const sandboxAgent = new ToolLoopAgent({
  model: 'openai/gpt-5.4',
  system: 'You are an agent with access to a shell environment.',
  tools: {
    shell: openai.tools.localShell({
      execute: async ({ action }) => {
        const [cmd, ...args] = action.command;
        const sandbox = await getSandbox(); // Vercel Sandbox
        const command = await sandbox.runCommand({ cmd, args });
        return { output: await command.stdout() };
      },
    }),
  },
});

Интеграция с UI

Модуль AI SDK UI предоставляет набор хуков для создания чат-ботов и интерфейсов на основе генеративного подхода. Эти хуки можно использовать в различных фреймворках, таких как Next.js, React, Svelte и Vue. Для установки пакета для нужного фреймворка, например для React, используй:

npm install @ai-sdk/react

Проект предлагает различные шаблоны, которые включают интеграции AI SDK для разных случаев использования, провайдеров и фреймворков, что облегчит старт разработки AI-приложений.

Сообщество

Общение и обмен опытом о AI SDK возможно на Vercel Community, где ты можешь задавать вопросы и делиться своими проектами.

Вклад в проект

Вклад в развитие AI SDK приветствуется. Перед началом работы рекомендуется ознакомиться с инструкциями по вкладке.

Авторы

Библиотека была разработана командой Vercel и Next.js, с участием представителей открытого сообщества.