---
name: ai-sdk
description: ai-sdk — an installable skill for AI agents, published by getsentry/webvitals.com.
---

# ai-sdk

ai-sdk — an installable skill for AI agents, published by getsentry/webvitals.com.

# ai-sdkby sentry
ai-sdk — an installable skill for AI agents, published by getsentry/webvitals.com.

`npx skills add https://github.com/getsentry/webvitals.com --skill ai-sdk`Download ZIPGitHub

## Prerequisites

Before searching docs, check if `node_modules/ai/docs/` exists. If not, install only the `ai` package using the project's package manager (e.g., `pnpm add ai`).

Do not install other packages at this stage. Provider packages (e.g., `@ai-sdk/openai`) and client packages (e.g., `@ai-sdk/react`) should be installed later when needed based on user requirements.

## Critical: Do Not Trust Internal Knowledge

Everything you know about the AI SDK is outdated or wrong. Your training data contains obsolete APIs, deprecated patterns, and incorrect usage.

When working with the AI SDK:

* Ensure `ai` package is installed (see Prerequisites)

* Search `node_modules/ai/docs/` and `node_modules/ai/src/` for current APIs

* If not found locally, search ai-sdk.dev documentation (instructions below)

* Never rely on memory - always verify against source code or docs

* `useChat` has changed significantly - check Common Errors before writing client code

* When deciding which model and provider to use (e.g. OpenAI, Anthropic, Gemini), use the Vercel AI Gateway provider unless the user specifies otherwise. See AI Gateway Reference for usage details.

* Always fetch current model IDs - Never use model IDs from memory. Before writing code that uses a model, run `curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '[.data[] | select(.id | startswith("provider/")) | .id] | reverse | .[]'` (replacing `provider` with the relevant provider like `anthropic`, `openai`, or `google`) to get the full list with newest models first. Use the model with the highest version number (e.g., `claude-sonnet-4-5` over `claude-sonnet-4` over `claude-3-5-sonnet`).

* Run typecheck after changes to ensure code is correct

* Be minimal - Only specify options that differ from defaults. When unsure of defaults, check docs or source rather than guessing or over-specifying.

If you cannot find documentation to support your answer, state that explicitly.

## Finding Documentation

### [email protected]+

Search bundled docs and source in `node_modules/ai/`:

* Docs: `grep "query" node_modules/ai/docs/`

* Source: `grep "query" node_modules/ai/src/`

Provider packages include docs at `node_modules/@ai-sdk/<provider>/docs/`.

### Earlier versions

* Search: `https://ai-sdk.dev/api/search-docs?q=your_query`

* Fetch `.md` URLs from results (e.g., `https://ai-sdk.dev/docs/agents/building-agents.md`)

## When Typecheck Fails

Before searching source code, grep Common Errors for the failing property or function name. Many type errors are caused by deprecated APIs documented there.

If not found in common-errors.md:

* Search `node_modules/ai/src/` and `node_modules/ai/docs/`

* Search ai-sdk.dev (for earlier versions or if not found locally)

## Building and Consuming Agents

### Creating Agents

Always use the `ToolLoopAgent` pattern. Search `node_modules/ai/docs/` for current agent creation APIs.

File conventions: See type-safe-agents.md for where to save agents and tools.

Type Safety: When consuming agents with `useChat`, always use `InferAgentUIMessage<typeof agent>` for type-safe tool results. See reference.

### Consuming Agents (Framework-Specific)

Before implementing agent consumption:

* Check `package.json` to detect the project's framework/stack

* Search documentation for the framework's quickstart guide

* Follow the framework-specific patterns for streaming, API routes, and client integration

## References

* Common Errors - Renamed parameters reference (parameters → inputSchema, etc.)

* AI Gateway - Gateway setup and usage

* Type-Safe Agents with useChat - End-to-end type safety with InferAgentUIMessage

## More skills from sentry
sentry-cocoa-sdkby sentryFull Sentry SDK setup for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS). Use when asked to "add Sentry to iOS", "add Sentry to Swift", "install…sentry-create-alertby sentryCreate Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow…sentry-dotnet-sdkby sentryFull Sentry SDK setup for .NET. Use when asked to "add Sentry to .NET", "install Sentry for C#", or configure error monitoring, tracing, profiling, logging, or…sentry-fix-issuesby sentryFind and fix issues from Sentry using MCP. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in…sentry-go-sdkby sentryFull Sentry SDK setup for Go. Use when asked to "add Sentry to Go", "install sentry-go", "setup Sentry in Go", or configure error monitoring, tracing, logging,…sentry-ios-swift-setupby sentrySetup Sentry in iOS/Swift apps. Use when asked to add Sentry to iOS, install sentry-cocoa SDK, or configure error monitoring for iOS applications using Swift…sentry-nextjs-sdkby sentryFull Sentry SDK setup for Next.js. Use when asked to "add Sentry to Next.js", "install @sentry/nextjs", or configure error monitoring, tracing, session replay,…sentry-otel-exporter-setupby sentryConfigure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation. Use when setting up OTel with Sentry,…

---

**Source**: https://github.com/getsentry/webvitals.com/tree/HEAD/.agents/skills/ai-sdk
**Author**: sentry
**Discovered via**: mcpservers.org