К основному содержанию
скилл CX Codex

ai-sdk-5 — скилл для Claude Code: что делает и как установить

Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии.

Apache-2.0 138 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-code
Открыть на GitHub

Что делает ai-sdk-5

Скилл содержит готовые шаблоны и правила перехода с AI SDK 4 на пятую версию фреймворка. В коде v5 хук useChat импортируется из пакета @ai-sdk/react, а сетевой слой настраивается через экземпляр DefaultChatTransport из пакета ai.

Вместо единой строки content структура сообщений UIMessage теперь опирается на массив parts. Внутри него лежат отдельные блоки: текст, изображения, вызовы инструментов tool-call и их результаты tool-result. Скилл показывает, как правильно разбирать эти части при рендеринге интерфейса.

В правилах также описаны серверные роуты со streamText, интеграция со стримингом из LangChain через toUIMessageStream, объявление инструментов с валидацией схем через zod и генерация текста через useCompletion. Если проект всё ещё использует сигнатуры параметров из v4 вроде прямого поля api в useChat, сборка интерфейса упадёт с ошибками типов.

Какие задачи решает

  • Обновить вызовы хука useChat и подключить DefaultChatTransport
  • Отрендерить массив parts в UIMessage вместо устаревшего поля content
  • Настроить серверный стриминг streamText с вызовами инструментов
  • Связать стримы LangChain с клиентским форматом через toUIMessageStream

Примеры запросов агенту

  • Собери React-компонент чата на Vercel AI SDK 5 с обработкой ошибок
  • Перепиши серверный роут /api/chat на streamText с тулом погоды
  • Покажи, как извлечь текстовые блоки из UIMessage parts в v5

Как установить ai-sdk-5

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-code

2Вручную: положить файлы

~/.claude/skills/ai-sdk-5/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ai-sdk-5/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ai-sdk-5

Как установить ai-sdk-5 в Claude Code?

Выполните в терминале команду npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-code.

Что делает скилл ai-sdk-5?

Он направляет ассистента использовать синтаксис Vercel AI SDK 5, исключая устаревшие методы и структуры данных из четвёртой версии библиотеки.

Какие пакеты требуются для примеров из скилла?

Для работы клиента нужен @ai-sdk/react, для ядра и транспорта — ai, а для серверных моделей и валидации — @ai-sdk/openai и zod.

Исходный текст

SKILL.md · Apache-2.0
---
name: ai-sdk-5
description: >
  Vercel AI SDK 5 patterns.
  Trigger: When building AI chat features - breaking changes from v4.
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

## Breaking Changes from AI SDK 4

```typescript
// ❌ AI SDK 4 (OLD)
import { useChat } from "ai";
const { messages, handleSubmit, input, handleInputChange } = useChat({
  api: "/api/chat",
});

// ✅ AI SDK 5 (NEW)
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";

const { messages, sendMessage } = useChat({
  transport: new DefaultChatTransport({ api: "/api/chat" }),
});
```

## Client Setup

```typescript
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
import { useState } from "react";

export function Chat() {
  const [input, setInput] = useState("");

  const { messages, sendMessage, isLoading, error } = useChat({
    transport: new DefaultChatTransport({ api: "/api/chat" }),
  });

  const handleSubmit = (e: React.FormEvent) => {
    e.preventDefault();
    if (!input.trim()) return;
    sendMessage({ text: input });
    setInput("");
  };

  return (
    <div>
      <div>
        {messages.map((message) => (
          <Message key={message.id} message={message} />
        ))}
      </div>

      <form onSubmit={handleSubmit}>
        <input
          value={input}
          onChange={(e) => setInput(e.target.value)}
          placeholder="Type a message..."
          disabled={isLoading}
        />
        <button type="submit" disabled={isLoading}>
          Send
        </button>
      </form>

      {error && <div>Error: {error.message}</div>}
    </div>
  );
}
```

## UIMessage Structure (v5)

```typescript
// ❌ Old: message.content was a string
// ✅ New: message.parts is an array

interface UIMessage {
  id: string;
  role: "user" | "assistant" | "system";
  parts: MessagePart[];
}

type MessagePart =
  | { type: "text"; text: string }
  | { type: "image"; image: string }
  | { type: "tool-call"; toolCallId: string; toolName: string; args: unknown }
  | { type: "tool-result"; toolCallId: string; result: unknown };

// Extract text from parts
function getMessageText(message: UIMessage): string {
  return message.parts
    .filter((part): part is { type: "text"; text: string } => part.type === "text")
    .map((part) => part.text)
    .join("");
}

// Render message
function Message({ message }: { message: UIMessage }) {
  return (
    <div className={message.role === "user" ? "user" : "assistant"}>
      {message.parts.map((part, index) => {
        if (part.type === "text") {
          return <p key={index}>{part.text}</p>;
        }
        if (part.type === "image") {
          return <img key={index} src={part.image} alt="" />;
        }
        return null;
      })}
    </div>
  );
}
```

## Server-Side (Route Handler)

```typescript
// app/api/chat/route.ts
import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";

export async function POST(req: Request) {
  const { messages } = await req.json();

  const result = await streamText({
    model: openai("gpt-4o"),
    messages,
    system: "You are a helpful assistant.",
  });

  return result.toDataStreamResponse();
}
```

## With LangChain

```typescript
// app/api/chat/route.ts
import { toUIMessageStream } from "@ai-sdk/langchain";
import { ChatOpenAI } from "@langchain/openai";
import { HumanMessage, AIMessage } from "@langchain/core/messages";

export async function POST(req: Request) {
  const { messages } = await req.json();

  const model = new ChatOpenAI({
    modelName: "gpt-4o",
    streaming: true,
  });

  // Convert UI messages to LangChain format
  const langchainMessages = messages.map((m) => {
    const text = m.parts
      .filter((p) => p.type === "text")
      .map((p) => p.text)
      .join("");
    return m.role === "user"
      ? new HumanMessage(text)
      : new AIMessage(text);
  });

  const stream = await model.stream(langchainMessages);

  return toUIMessageStream(stream).toDataStreamResponse();
}
```

## Streaming with Tools

```typescript
import { openai } from "@ai-sdk/openai";
import { streamText, tool } from "ai";
import { z } from "zod";

const result = await streamText({
  model: openai("gpt-4o"),
  messages,
  tools: {
    getWeather: tool({
      description: "Get weather for a location",
      parameters: z.object({
        location: z.string().describe("City name"),
      }),
      execute: async ({ location }) => {
        // Fetch weather data
        return { temperature: 72, condition: "sunny" };
      },
    }),
  },
});
```

## useCompletion (Text Generation)

```typescript
import { useCompletion } from "@ai-sdk/react";
import { DefaultCompletionTransport } from "ai";

const { completion, complete, isLoading } = useCompletion({
  transport: new DefaultCompletionTransport({ api: "/api/complete" }),
});

// Trigger completion
await complete("Write a haiku about");
```

## Error Handling

```typescript
const { error, messages, sendMessage } = useChat({
  transport: new DefaultChatTransport({ api: "/api/chat" }),
  onError: (error) => {
    console.error("Chat error:", error);
    toast.error("Failed to send message");
  },
});

// Display error
{error && (
  <div className="error">
    {error.message}
    <button onClick={() => sendMessage({ text: lastInput })}>
      Retry
    </button>
  </div>
)}
```

## Keywords
ai sdk, vercel ai, chat, streaming, langchain, openai, llm

© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
vercel-ai-sdk existential-birds Справочник по Vercel AI SDK для сборки стриминговых чатов, вызова инструментов и обработки вложений. CX Codex +1 101установок migrate-ai-sdk-v6-to-v7 vercel Скилл migrate-ai-sdk-v6-to-v7 переводит проекты с Vercel AI SDK 6.x на версию 7.0. Помогает обновить зависимости, исправить сломанные типы и заменить устаревшие параметры вызовов. CX Codex +1 6 000установок mem0-vercel-ai-sdk mem0ai Скилл mem0-vercel-ai-sdk помогает подключить память Mem0 к Vercel AI SDK. Он учит агента внедрять историю и контекст в вызовы generateText и streamText. CX Codex +1 552установок migrating-vercel-ai-sdk-and-eve-to-pydantic-ai pydantic Скилл migrating-vercel-ai-sdk-and-eve-to-pydantic-ai для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode переводит TypeScript-проекты на Vercel AI SDK или Eve в Python с Pydantic AI. CX Codex +1 469установок aicore-sdk-js SAP Скилл aicore-sdk-js для Claude Code генерирует рабочий TypeScript и JavaScript код для интеграции с SAP GenAI Hub. Включается при запросах на вызовы моделей через пакеты @sap-ai-sdk. CX Codex +1 192установок typescript-nextjs-react-cursorrules-prompt-file PatrickJS Правило typescript-nextjs-react-cursorrules-prompt-file настраивает Cursor на работу со стеком Next.js 14 App Router, React, Tailwind и TypeScript. Оно помогает при создании веб-приложений со стримингом ответов через Vercel AI SDK. CX Codex +1 ★ 41 178звёзд репо

Из того же набора20

Весь набор →
elixir-antipatterns Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок nextjs-15 Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware. CX Codex +1 185установок electron Организует структуру проекта на Electron, настраивает безопасный IPC через contextBridge и даёт типизированные шаблоны взаимодействия между процессами. CX Codex +1 175установок skill-creator Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы. CX Codex +1 171установок django-drf Скилл django-drf помогает проектировать REST API на Django: ViewSet, сериализаторы, фильтры и тесты. Пригодится при сборке нового API. CX Codex +1 162установок angular-forms Скилл angular-forms для работы с формами Angular: покрывает Signal Forms (экспериментальные, на Angular 21+) и Reactive Forms для продакшена. Триггер срабатывает при работе с валидацией, состоянием формы или её созданием. CX Codex +1 150установок spring-boot-3 Набор правил для ИИ-агента: как писать конфигурацию, инъекцию зависимостей и REST-слой в Spring Boot 3, чтобы код не разъезжался по стилю. CX Codex +1 143установок jira-epic Скилл jira-epic генерирует готовые описания эпиков в Jira по стандарту Prowler со схемами Mermaid и разбивкой на задачи. CX Codex +1 138установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой