ai-sdk
AI SDK documentation and guidance for building AI-powered features with Vercel's framework.
- Covers core APIs including
generateText,streamText,ToolLoopAgent,embed, and tool calling across multiple AI providers (OpenAI, Anthropic, Google, etc.) - Supports building agents, chatbots, RAG systems, and text generation with structured output and streaming capabilities
- Includes React hooks (
useChat,useCompletion) and framework-specific patterns for Next.js, SvelteKit, and other platforms - Provides type-safe agent consumption with
InferAgentUIMessagefor end-to-end type safety and local DevTools for debugging
Prerequisites
This information is for AI SDK 7. Compare to version in node_modules/ai/package.json. If the versions don't match, warn the user.
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:
More in Next.js
vercel-react-best-practices
69 prioritized React and Next.js performance rules across 8 categories
vercel-labs/agent-skillsvercel-composition-patterns
Composable component architecture patterns for scalable Next.js apps
vercel-labs/agent-skillsnext-best-practices
File conventions, RSC boundaries, data patterns, async APIs, and metadata
vercel-labs/next-skillsdeploy-to-vercel
Deploy Next.js apps to Vercel with correct config and environment setup
vercel-labs/agent-skillsnext-cache-components
PPR, use cache directive, cacheLife, cacheTag, and revalidateTag
vercel-labs/next-skills