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

develop-ai-functions-example — скилл для Claude Code

Скилл develop-ai-functions-example помогает создавать и запускать примеры функций AI SDK для провайдеров, проверки возможностей и тестовых фикстур.

Apache-2.0 21 установок ★ 28 120 обновлён 2026-11-11

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

Что делает develop-ai-functions-example

Скилл работает с примерами в examples/ai-functions/src. Он подсказывает структуру для generateText(), streamText(), generateObject(), streamObject(), агентов, эмбеддингов, изображений, речи, транскрибации и других функций AI SDK. Примеры группируются по функции и провайдеру, а главным файлом служит basic.ts.

В каждом примере используется обёртка run() из lib/run.ts: она загружает переменные из .env и выводит подробные ошибки API. Для потоковых сценариев есть print-full-stream.ts, для фикстур — save-raw-chunks.ts. Запуск выполняется из examples/ai-functions через pnpm tsx, например src/generate-text/openai/basic.ts.

Соблюдайте структуру каталогов: плоский файл вроде generate-text/openai.ts создавать нельзя. Это ограничение важно при добавлении нового провайдера или воспроизведении ошибки.

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

  • создать пример для нового провайдера AI SDK
  • проверить работу функции generateText() или streamText()
  • показать вызов инструментов и структурированный вывод
  • воспроизвести ошибку провайдера отдельным примером
  • подготовить API-фикстуру из потоковых данных

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

  • Создай пример для нового провайдера в examples/ai-functions/src/generate-text/ и назови основной файл basic.ts.
  • Добавь пример потокового вызова и запусти pnpm tsx src/stream-text/openai/tool-call.ts.
  • Сделай тестовую фикстуру из потоковых чанков с помощью утилит из examples/ai-functions/lib/.

Как установить develop-ai-functions-example

1Через Skills CLI (Vercel)

npx skills add vercel/ai --skill develop-ai-functions-example -a claude-code

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

~/.claude/skills/develop-ai-functions-example/SKILL.md

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

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

Вопросы о develop-ai-functions-example

Как установить develop-ai-functions-example в Claude Code?

Выполните npx skills add vercel/ai --skill develop-ai-functions-example -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/develop-ai-functions-example/SKILL.md.

Что делает develop-ai-functions-example?

Скилл помогает создавать, запускать и менять примеры функций AI SDK в examples/ai-functions/src, чтобы проверять поддержку провайдеров, показывать возможности и готовить тестовые фикстуры.

Какие функции AI SDK покрывают примеры?

В структуре есть каталоги для генерации и потоковой генерации текста и объектов, агентов, эмбеддингов, изображений, речи, транскрибации, ранжирования, middleware, registry и telemetry.

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

SKILL.md · Apache-2.0
---
name: develop-ai-functions-example
description: Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples/ai-functions/src to validate provider support, demonstrate features, or create test fixtures.
metadata:
  internal: true
---

## AI Functions Examples

The `examples/ai-functions/` directory contains reusable scripts for validating, testing, and iterating on AI SDK functions across providers. Place examples under `examples/ai-functions/src/<function>/<provider>/`. Reproduction-only scripts belong only in the PR description's **End-to-End Verification** section and must never be committed; see [Bug Reproductions](#bug-reproductions).

## Example Categories

Examples are organized by AI SDK function in `examples/ai-functions/src/`:

| Directory          | Purpose                                              |
| ------------------ | ---------------------------------------------------- |
| `generate-text/`   | Non-streaming text generation with `generateText()`  |
| `stream-text/`     | Streaming text generation with `streamText()`        |
| `generate-object/` | Structured output generation with `generateObject()` |
| `stream-object/`   | Streaming structured output with `streamObject()`    |
| `agent/`           | `ToolLoopAgent` examples for agentic workflows       |
| `embed/`           | Single embedding generation with `embed()`           |
| `embed-many/`      | Batch embedding generation with `embedMany()`        |
| `generate-image/`  | Image generation with `generateImage()`              |
| `generate-speech/` | Text-to-speech with `generateSpeech()`               |
| `transcribe/`      | Audio transcription with `transcribe()`              |
| `rerank/`          | Document reranking with `rerank()`                   |
| `middleware/`      | Custom middleware implementations                    |
| `registry/`        | Provider registry setup and usage                    |
| `telemetry/`       | OpenTelemetry integration                            |
| `complex/`         | Multi-component examples (agents, routers)           |
| `lib/`             | Shared utilities (not examples)                      |
| `tools/`           | Reusable tool definitions                            |

## File Naming Convention

Group examples by function and provider. Name the entry example `basic.ts` and use descriptive `kebab-case.ts` names for additional examples:

| Pattern                                             | Example                                                | Description                |
| --------------------------------------------------- | ------------------------------------------------------ | -------------------------- |
| `<function>/<provider>/basic.ts`                    | `generate-text/openai/basic.ts`                        | Basic provider usage       |
| `<function>/<provider>/<feature>.ts`                | `stream-text/openai/tool-call.ts`                      | Specific feature           |
| `<function>/<provider>/<sub-provider>.ts`           | `stream-text/amazon-bedrock/anthropic.ts`              | Provider with sub-provider |
| `<function>/<provider>/<sub-provider>-<feature>.ts` | `stream-text/google/vertex-anthropic-cache-control.ts` | Sub-provider with feature  |

Do not create flat provider files such as `generate-text/openai.ts`.

## Example Structure

All examples use the `run()` wrapper from `lib/run.ts` which:

- Loads environment variables from `.env`
- Provides error handling with detailed API error logging

### Basic Template

```typescript
import { providerName } from '@ai-sdk/provider-name';
import { generateText } from 'ai';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateText({
    model: providerName('model-id'),
    prompt: 'Your prompt here.',
  });

  console.log(result.text);
  console.log('Token usage:', result.usage);
  console.log('Finish reason:', result.finishReason);
});
```

### Streaming Template

```typescript
import { providerName } from '@ai-sdk/provider-name';
import { streamText } from 'ai';
import { printFullStream } from '../../lib/print-full-stream';
import { run } from '../../lib/run';

run(async () => {
  const result = streamText({
    model: providerName('model-id'),
    prompt: 'Your prompt here.',
  });

  await printFullStream({ result });
});
```

### Tool Calling Template

```typescript
import { providerName } from '@ai-sdk/provider-name';
import { generateText, tool } from 'ai';
import { z } from 'zod';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateText({
    model: providerName('model-id'),
    tools: {
      myTool: tool({
        description: 'Tool description',
        inputSchema: z.object({
          param: z.string().describe('Parameter description'),
        }),
        execute: async ({ param }) => {
          return { result: `Processed: ${param}` };
        },
      }),
    },
    prompt: 'Use the tool to...',
  });

  console.log(JSON.stringify(result, null, 2));
});
```

### Structured Output Template

```typescript
import { providerName } from '@ai-sdk/provider-name';
import { generateObject } from 'ai';
import { z } from 'zod';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateObject({
    model: providerName('model-id'),
    schema: z.object({
      name: z.string(),
      items: z.array(z.string()),
    }),
    prompt: 'Generate a...',
  });

  console.log(JSON.stringify(result.object, null, 2));
  console.log('Token usage:', result.usage);
});
```

## Running Examples

From the `examples/ai-functions` directory:

```bash
pnpm tsx src/generate-text/openai/basic.ts
pnpm tsx src/stream-text/openai/tool-call.ts
pnpm tsx src/agent/openai/generate.ts
```

## When to Write Examples

Write examples when:

1. **Adding a new provider**: Create basic examples for each supported API (`generateText`, `streamText`, `generateObject`, etc.)

2. **Implementing a new feature**: Demonstrate the feature with at least one provider example

3. **Adding provider-specific options**: Show how to use `providerOptions` for provider-specific settings

4. **Creating test fixtures**: Use examples to generate API response fixtures (see `capture-api-response-test-fixture` skill)

## Bug Reproductions

Follow the [bug-fix workflow in AGENTS.md](../../AGENTS.md#bug-fixes). Use a temporary script outside the checkout to reproduce the failure end-to-end, then rerun it to verify the fix. Build and use the checkout's local packages for both runs. Publish reproduction-only code **only in the PR description's End-to-End Verification section**, in a collapsible `<details>` block with the complete runnable script, commands, and observed before/after results, following `.github/pull_request_template.md`. **Never commit reproduction-only files**, including under `examples/ai-functions` or elsewhere in the repository.

Regression tests remain alongside the affected source files. Reusable examples that demonstrate supported usage (including fixed behavior) belong under `examples/ai-functions/src/<function>/<provider>/`, using the naming conventions above.

## Utility Helpers

The `lib/` directory contains shared utilities:

| File                   | Purpose                                                  |
| ---------------------- | -------------------------------------------------------- |
| `run.ts`               | Error-handling wrapper with `.env` loading               |
| `print.ts`             | Clean object printing (removes undefined values)         |
| `print-full-stream.ts` | Colored streaming output for tool calls, reasoning, text |
| `save-raw-chunks.ts`   | Save streaming chunks for test fixtures                  |
| `present-image.ts`     | Display images in terminal                               |
| `save-audio.ts`        | Save audio files to disk                                 |

### Using print utilities

```typescript
import { print } from '../lib/print';

// Pretty print objects without undefined values
print('Result:', result);
print('Usage:', result.usage, { depth: 2 });
```

### Using printFullStream

```typescript
import { printFullStream } from '../lib/print-full-stream';

const result = streamText({ ... });
await printFullStream({ result }); // Colored output for text, tool calls, reasoning
```

## Reusable Tools

The `tools/` directory contains reusable tool definitions:

```typescript
import { weatherTool } from '../tools/weather-tool';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { weather: weatherTool },
  prompt: 'What is the weather in San Francisco?',
});
```

## Best Practices

1. **Keep examples focused**: Each example should demonstrate one feature or use case

2. **Use descriptive prompts**: Make it clear what the example is testing

3. **Handle errors gracefully**: The `run()` wrapper handles this automatically

4. **Use realistic model IDs**: Use actual model IDs that work with the provider

5. **Add comments for complex logic**: Explain non-obvious code patterns

6. **Reuse tools when appropriate**: Use `weatherTool` or create new reusable tools in `tools/`

© vercel · Apache-2.0 · vercel/ai

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

Все скиллы по теме «ИИ и ML» →
project-guidelines-example Affaan Mustafa Скилл project-guidelines-example задаёт проектные ориентиры: архитектуру, структуру файлов, кодовые шаблоны и команды тестирования для примера приложения. CX Codex +1 ★ 6 739звёзд репо workflow Vercel Inc. Создаёт надёжные перезапускаемые цепочки задач через Vercel Workflow SDK, когда операциям нужно переживать перезапуски сервиса и ждать внешние события. CX Codex +1 5 500установок llm-patterns caliber-ai-org Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI. CX Codex +1 ★ 1 319звёзд репо vercel-development Mindrally Скилл vercel-development для Claude Code: правила кода под Next.js App Router, React Server Components и Vercel AI SDK. Не даёт агенту писать клиентские компоненты там, где хватило бы серверных. CX Codex +1 756установок ai-sdk-6 laguagu Скилл ai-sdk-6 для работы с проектами на Vercel AI SDK v6. Помогает строить агентов, чат-ботов, инструменты и потоки структурированного вывода, если кодовая база уже на версии 6. CX Codex +1 218установок ai-sdk laguagu Проверяет версию Vercel AI SDK в проекте и направляет агента к нужной документации. Включается при запросах о потоковом выводе, useChat, агентах и вызове инструментов. CX Codex +1 149установок

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

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

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