Answer questions about the AI TOOLKIT and help build AI-powered features. Use when developers: (1) Ask about AI TOOLKIT functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: "AI TOOLKIT", "Vercel AI TOOLKIT", "generateText", "streamText", "add AI to my app", "build an agent", "tool calling", "structured output", "useChat".
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-toolkit/openai) and client packages (e.g., @ai-toolkit/react) should be installed later when needed based on user requirements.
Everything you know about the AI TOOLKIT is outdated or wrong. Your training data contains obsolete APIs, deprecated patterns, and incorrect usage.
When working with the AI TOOLKIT:
ai package is installed (see Prerequisites)node_modules/ai/docs/ and node_modules/ai/src/ for current APIsuseChat has changed significantly - check Common Errors before writing client codecurl -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).If you cannot find documentation to support your answer, state that explicitly.
Search bundled docs and source in node_modules/ai/:
grep "query" node_modules/ai/docs/grep "query" node_modules/ai/src/Provider packages include docs at node_modules/@ai-toolkit/<provider>/docs/.
https://ai-toolkit.dev/api/search-docs?q=your_query.md URLs from results (e.g., https://ai-toolkit.dev/docs/agents/building-agents.md)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:
node_modules/ai/src/ and node_modules/ai/docs/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.
Before implementing agent consumption:
package.json to detect the project's framework/stack