version: "1.0.5" name: ai-sdk description: 'Answer questions about the AI SDK and help build AI-powered features. Use when developers ask about Vercel AI SDK, generateText, streamText, ToolLoopAgent, useChat, providers, tools, structured output, embeddings, streaming, or adding AI to an app. First identify the installed major version and route version-specific work: use ai-sdk-7 for AI SDK 7 features/migrations such as WorkflowAgent, HarnessAgent, reasoning, runtime/tools context, toolApproval, telemetry, realtime, or v6-to-v7 upgrades; use ai-sdk-6 for v6 code.'

AI SDK version and documentation routing

Identify ai and the provider/React package versions in the relevant workspace's manifest, lockfile or installed package. Keep the installed major unless an upgrade is requested.

• AI SDK 7 implementation or migration: use ai-sdk-7.
• AI SDK 6 maintenance: use ai-sdk-6.
• Unknown, mixed or older versions: resolve them before applying either API set.
• New apps: start on the current major (7 when written; npm view ai dist-tags

confirms). ai@7 pairs with @ai-sdk/react@4, ai@6 with @ai-sdk/react@3. Provider majors differ per package, so install each provider's latest for v7 and its ai-v6 dist-tag for v6 (npm view <pkg> dist-tags).

Find the API that matches the app

Search the resolved package's docs/, types and src/ (when shipped) first; they work without network. ai bundles docs from 6.0.32 and in 7.x; 6.0.0-6.0.31 have no docs. The docs tree mirrors the website: ai-sdk.dev/docs/<section>/<page> is ai/docs/<nn>-<section>/<nn>-<page>.mdx, so an ai-sdk.dev/docs link in these skills can be read from the installed major's copy. Provider packages ship docs/<nn>-<provider>.mdx. @ai-sdk/react, @ai-sdk/workflow, @ai-sdk/harness, @ai-sdk/otel and @ai-sdk/mcp ship no docs; their guides are in ai/docs and their API in dist/*.d.ts. Monorepo hoisting and Yarn PnP may change the paths; do not install or upgrade a dependency solely to obtain docs.

When local documentation is unavailable, use the matching repository tag (vercel/ai, tag ai@<version>, content/docs/) or docs version. The documentation search and Markdown page variants help locate the relevant feature. Repository main and the default website can target a newer major than the app. With neither local docs nor network, say which API facts remain unverified. Append &tag=v6 (v5, v6 or v7) to scope search results to a major.

Choose model IDs from the app's provider configuration or current provider catalog. The Gateway catalog can aid discovery; its IDs and capability availability do not imply that another provider accepts them. Choose capability, latency and cost for the task.

Targeted references

• Common errors: obsolete names and protocol mismatches.
• Typed agents: UI inference and server/client boundaries.
• DevTools: local debugging.
• Examples: provider-specific official code.

Use defaults when they fit. Typecheck changed integrations and exercise their streaming/tool path; a supported symbol can still be used with the wrong callback scope, result semantics or provider.