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

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

Справочник по Vercel AI SDK для сборки стриминговых чатов, вызова инструментов и обработки вложений.

Apache-2.0 101 установок ★ 89 обновлён 2026-09-15

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

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

Скилл даёт ассистенту готовые шаблоны для работы с библиотеками @ai-sdk/react и ai. Он объясняет хук useChat, состояния ChatStatus (ready, submitted, streaming, error) и компонентную структуру сообщений UIMessage. Вместо одного поля текста здесь используется массив частей (parts): фрагменты ответов, вызовы тулов, прикреплённые файлы и цепочки рассуждений.

На бэкенде скилл настраивает связку streamText с методом toUIMessageStreamResponse. Внутри описаны два сценария для тулов: исполнение на сервере через свойство execute или передача в браузер через события onToolCall и метод addToolOutput. Также есть примеры троттлинга рендеринга через experimental_throttle и перезапуска сообщений.

Без передачи originalMessages в toUIMessageStreamResponse стриминг ответов с сохранением контекста сломается.

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

  • настроить хук useChat со стримингом и обработкой ошибок
  • реализовать клиентские и серверные вызовы инструментов через streamText
  • рендерить составные сообщения UIMessage с файлами и статусами тулов
  • организовать автоматический перезапуск запроса после ответа всех инструментов

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

  • Собери React-компонент чата на базе хука useChat из @ai-sdk/react с поддержкой прикрепления файлов
  • Напиши роут с streamText, который вызывает инструмент погоды и возвращает toUIMessageStreamResponse
  • Добавь обработку клиентского инструмента через onToolCall и вызов addToolOutput

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

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill vercel-ai-sdk -a claude-code

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

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

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

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

Вопросы о vercel-ai-sdk

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

Выполните в терминале команду npx skills add existential-birds/beagle --skill vercel-ai-sdk -a claude-code. Файл скилла запишется по пути ~/.claude/skills/vercel-ai-sdk/SKILL.md.

Что делает vercel-ai-sdk?

Он предоставляет агенту правила и паттерны кода для интеграции Vercel AI SDK: от серверного генератора SSE-ответов до хука useChat на клиенте.

Чем клиентские инструменты отличаются от серверных в этом скилле?

Серверные инструменты запускаются на API-роуте через функцию execute, а клиентские оставляют выполнение браузеру и требуют вызова onToolCall вместе с addToolOutput.

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

SKILL.md · Apache-2.0
---
name: vercel-ai-sdk
description: Vercel AI SDK for building chat interfaces with streaming. Use when implementing useChat hook, handling tool calls, streaming responses, or building chat UI. Triggers on useChat, @ai-sdk/react, UIMessage, ChatStatus, streamText, toUIMessageStreamResponse, addToolOutput, onToolCall, sendMessage.
---

# Vercel AI SDK

The Vercel AI SDK provides React hooks and server utilities for building streaming chat interfaces with support for tool calls, file attachments, and multi-step reasoning.

## Quick Reference

### Basic useChat Setup

```typescript
import { useChat } from '@ai-sdk/react';

const { messages, status, sendMessage, stop, regenerate } = useChat({
  id: 'chat-id',
  messages: initialMessages,
  onFinish: ({ message, messages, isAbort, isError }) => {
    console.log('Chat finished');
  },
  onError: (error) => {
    console.error('Chat error:', error);
  }
});

// Send a message
sendMessage({ text: 'Hello', metadata: { createdAt: Date.now() } });

// Send with files
sendMessage({
  text: 'Analyze this',
  files: fileList // FileList or FileUIPart[]
});
```

### ChatStatus States

The `status` field indicates the current state of the chat:

- **`ready`**: Chat is idle and ready to accept new messages
- **`submitted`**: Message sent to API, awaiting response stream start
- **`streaming`**: Response actively streaming from the API
- **`error`**: An error occurred during the request

### Message Structure

Messages use the `UIMessage` type with a parts-based structure:

```typescript
interface UIMessage {
  id: string;
  role: 'system' | 'user' | 'assistant';
  metadata?: unknown;
  parts: Array<UIMessagePart>; // text, file, tool-*, reasoning, etc.
}
```

Part types include:
- `text`: Text content with optional streaming state
- `file`: File attachments (images, documents)
- `tool-{toolName}`: Tool invocations with state machine
- `reasoning`: AI reasoning traces
- `data-{typeName}`: Custom data parts

### Server-Side Streaming

```typescript
import { streamText } from 'ai';
import { convertToModelMessages } from 'ai';

const result = streamText({
  model: openai('gpt-4'),
  messages: convertToModelMessages(uiMessages),
  tools: {
    getWeather: tool({
      description: 'Get weather',
      inputSchema: z.object({ city: z.string() }),
      execute: async ({ city }) => {
        return { temperature: 72, weather: 'sunny' };
      }
    })
  }
});

return result.toUIMessageStreamResponse({
  originalMessages: uiMessages,
  onFinish: ({ messages }) => {
    // Save to database
  }
});
```

### Tool Handling Patterns

**Client-Side Tool Execution:**
```typescript
const { addToolOutput } = useChat({
  onToolCall: async ({ toolCall }) => {
    if (toolCall.toolName === 'getLocation') {
      addToolOutput({
        tool: 'getLocation',
        toolCallId: toolCall.toolCallId,
        output: 'San Francisco'
      });
    }
  }
});
```

**Rendering Tool States:**
```typescript
{message.parts.map(part => {
  if (part.type === 'tool-getWeather') {
    switch (part.state) {
      case 'input-streaming':
        return <pre>{JSON.stringify(part.input, null, 2)}</pre>;
      case 'input-available':
        return <div>Getting weather for {part.input.city}...</div>;
      case 'output-available':
        return <div>Weather: {part.output.weather}</div>;
      case 'output-error':
        return <div>Error: {part.errorText}</div>;
    }
  }
})}
```

## Reference Files

Detailed documentation on specific aspects:

- **[use-chat.md](references/use-chat.md)**: Complete useChat API reference
- **[messages.md](references/messages.md)**: UIMessage structure and part types
- **[streaming.md](references/streaming.md)**: Server-side streaming implementation
- **[tools.md](references/tools.md)**: Tool definition and execution patterns

## Common Patterns

### Error Handling

```typescript
const { error, clearError } = useChat({
  onError: (error) => {
    toast.error(error.message);
  }
});

// Clear error and reset to ready state
if (error) {
  clearError();
}
```

### Message Regeneration

```typescript
const { regenerate } = useChat();

// Regenerate last assistant message
await regenerate();

// Regenerate specific message
await regenerate({ messageId: 'msg-123' });
```

### Custom Transport

```typescript
import { DefaultChatTransport } from 'ai';

const { messages } = useChat({
  transport: new DefaultChatTransport({
    api: '/api/chat',
    prepareSendMessagesRequest: ({ id, messages, trigger, messageId }) => ({
      body: {
        chatId: id,
        lastMessage: messages[messages.length - 1],
        trigger,
        messageId
      }
    })
  })
});
```

### Performance Optimization

```typescript
// Throttle UI updates to reduce re-renders
const chat = useChat({
  experimental_throttle: 100 // Update max once per 100ms
});
```

### Automatic Message Sending

```typescript
import { lastAssistantMessageIsCompleteWithToolCalls } from 'ai';

const chat = useChat({
  sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls
  // Automatically resend when all tool calls have outputs
});
```

## Type Safety

The SDK provides full type inference for tools and messages:

```typescript
import { InferUITools, UIMessage } from 'ai';

const tools = {
  getWeather: tool({
    inputSchema: z.object({ city: z.string() }),
    execute: async ({ city }) => ({ weather: 'sunny' })
  })
};

type MyMessage = UIMessage<
  { createdAt: number }, // Metadata type
  UIDataTypes,
  InferUITools<typeof tools> // Tool types
>;

const { messages } = useChat<MyMessage>();
```

## Key Concepts

### Parts-Based Architecture

Messages use a parts array instead of a single content field. This allows:
- Streaming text while maintaining other parts
- Tool calls with independent state machines
- File attachments and custom data mixed with text

### Tool State Machine

Tool parts progress through states:
1. `input-streaming`: Tool input streaming (optional)
2. `input-available`: Tool input complete
3. `approval-requested`: Waiting for user approval (optional)
4. `approval-responded`: User approved/denied (optional)
5. `output-available`: Tool execution complete
6. `output-error`: Tool execution failed
7. `output-denied`: User denied approval

### Streaming Protocol

The SDK uses Server-Sent Events (SSE) with UIMessageChunk types:
- `text-start`, `text-delta`, `text-end`
- `tool-input-available`, `tool-output-available`
- `reasoning-start`, `reasoning-delta`, `reasoning-end`
- `start`, `finish`, `abort`

### Client vs Server Tools

**Server-side tools** have an `execute` function and run on the API route.

**Client-side tools** omit `execute` and are handled via `onToolCall` and `addToolOutput`.

## Gates

Use this **sequence**; treat a step as incomplete until the pass condition is true in code or UI (not “should work”).

1. **Streaming route** — *Pass if:* the chat handler chains `convertToModelMessages` → `streamText` (or the SDK pattern your app standardizes) → `toUIMessageStreamResponse` (or equivalent stream response). *Fail if:* responses are plain JSON strings without the UI message stream contract.
2. **Client ↔ route** — *Pass if:* `useChat` `id` / `DefaultChatTransport` `api` (and `prepareSendMessagesRequest` body) matches the route path and the body the server reads. *Fail if:* client posts to a different path or shape than the handler expects.
3. **Tools closed loop** — *Pass if:* every tool in `tools` has server `execute` **or** `onToolCall` + `addToolOutput` with the same `toolCallId`, and the UI handles the `tool-*` part states you surface. *Fail if:* a tool name exists in `tools` but has no handler or missing states in the renderer.
4. **Persistence (if any)** — *Pass if:* before saving, the server runs `validateUIMessages` (or stricter validation). *Fail if:* unvalidated client payloads are written to storage.

## Best Practices

1. Always handle the `error` state and provide user feedback
2. Use `experimental_throttle` for high-frequency updates
3. Implement proper loading states based on `status`
4. Type your messages with custom metadata and tools
5. Use `sendAutomaticallyWhen` for multi-turn tool workflows
6. Handle all tool states in the UI for better UX
7. Use `stop()` to allow users to cancel long-running requests
8. Validate messages with `validateUIMessages` on the server

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — vercel-ai-sdk от других авторов.

vercel-ai-sdk wsimmonds Подсказывает агенту, как писать код на Vercel AI SDK v5: чат через useChat, стриминг, вызов инструментов, эмбеддинги. CX Codex +1 348установок 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установок ai-sdk-5 gentleman-programming Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии. CX Codex +1 138установок ai-ui-patterns patterns.dev Скилл ai-ui-patterns для Claude Code описывает паттерны React-чатов: стриминг ответов, состояние диалога и обработку ошибок. Включается при работе с файлами .tsx и .jsx. CX Codex +1 2 200установок ai-sdk laguagu Проверяет версию Vercel AI SDK в проекте и направляет агента к нужной документации. Включается при запросах о потоковом выводе, useChat, агентах и вызове инструментов. CX Codex +1 149установок 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установок

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

Весь набор →
pydantic-ai-model-integration Скилл pydantic-ai-model-integration помогает настроить провайдеров LLM, цепочки fallback, стриминг и лимиты токенов в библиотеке PydanticAI. CX Codex +1 120установок review-ai-writing Скилл review-ai-writing находит следы текстов нейросетей в документации, комментариях к коду, текстах коммитов и описаниях пулреквестов. Пригодится при проверке репозитория на канцелярский слог и роботизированные фразы. CX Codex +1 119установок wish-ssh-code-review Скилл wish-ssh-code-review проверяет код SSH-серверов на базе Go-библиотеки Charmbracelet Wish: порядок middleware, работу с PTY, ключи хоста и корректное завершение работы. CX Codex +1 119установок urlsession-code-review Скилл urlsession-code-review разбирает сетевой код на URLSession в iOS и macOS: статус-коды, кэш, таймауты и фоновые сессии. Находки идут с привязкой file:line. CX Codex +1 116установок elixir-security-review Скилл elixir-security-review проверяет код на Elixir на уязвимости: инъекции кода, переполнение таблицы атомов и утечки секретов. CX Codex +1 110установок elixir-performance-review Скилл elixir-performance-review для Claude Code проверяет код на Elixir и ищет узкие места в GenServer, памяти, конкурентности и базе данных. Находит причины просадки сервиса под нагрузкой. CX Codex +1 107установок elixir-writing-docs Скилл elixir-writing-docs для Claude Code оформляет документацию Elixir в файлах .ex: аннотации ExDoc, doctests и метаданные. CX Codex +1 106установок rust-code-review Скилл rust-code-review для Claude Code проверяет Rust-код при ревью файлов .rs. Разбирает владение, заимствования, обработку ошибок, трейты и небезопасный код. CX Codex +1 104установок

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

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