ai-sdk-core

核心用法

ai-sdk-core 是围绕 Vercel AI SDK v5/v6 构建的后端 AI 开发技能，涵盖文本生成、结构化输出、多模态处理、工具调用等完整能力。核心 API 包括 generateText()()/()/streamText()() 用于文本生成，v6 新增的 Output API（Output.object()()/()/Output.array()()/()/Output.choice()()）彻底替代了已废弃的 generateObject//streamObject。支持语音合成（TTS）、语音识别（STT）、图像生成、文本嵌入等多模态能力，并集成 OpenAI、Anthropic、Google、Cloudflare Workers AI 等 69+ 提供商。

v6 引入多项关键特性：Agent 抽象层（ToolLoopAgent）、人机协同审批机制（needsApproval）、RAG 重排序（rerank）、MCP 工具支持（含安全警告）、语言模型中间件（wrapLanguageModel）以及 OpenTelemetry 遥测。技能特别针对 Cloudflare Workers 优化，提供延迟初始化方案解决 270ms+ 启动限制问题。

显著优点

1. 权威技术来源：内容直接整理自 Vercel 官方文档，API 示例经过验证，涵盖 GPT-5.2、Claude 4.5、Gemini 2.5 等 2025-2026 最新模型
2. 生产级安全指导：MCP 工具章节提供详细的安全警告和静态工具生成方案，人机协同审批机制给出明确的最佳实践
3. 全面的错误解决方案：覆盖 15 个高频错误（AI_APICallError、Worker 启动限制、流式响应失败等），每个错误提供根本原因分析和可复现代码
4. 迁移支持完善：v4→v5 迁移指南包含完整的 Breaking Changes 清单、自动化迁移工具（npx ai migrate）和逐项检查清单
5. 边缘计算优化：针对 Cloudflare Workers 的启动性能问题提供延迟加载方案，确保符合 400ms 启动限制

潜在缺点与局限性

1. 版本迭代风险：AI SDK v6 仍在快速迭代（v6.0.40 存在破坏性变更被回滚），部分 API 标记为 experimental（如 experimental_createMCPClient）
2. MCP 工具生产限制：动态 MCP 工具存在显著安全风险，官方推荐转为静态工具生成，增加了维护复杂度
3. 提供商特定 Bug：文档明确列出 3 个未修复的提供商特定问题（Gemini 隐式缓存失效、Anthropic 工具错误解析崩溃、tool-result 消息位置错误），需要开发者手动实现 workaround
4. 前端能力分离：React Hooks（useChat 等）需配合 ai-sdk-ui 技能使用，本技能仅覆盖后端场景
5. 流式恢复限制：浏览器标签切换导致的流中断无自动重连机制，需开发者自行实现 visibilitychange 检测和 reload 逻辑

适合的目标群体

• 后端开发者：构建 Node.js/Next.js/Cloudflare Workers AI 服务的工程师
• AI 应用架构师：需要多提供商统一抽象、工具调用编排、Agent 工作流设计的团队
• 迁移项目团队：正在从 AI SDK v4 升级至 v5/v6 的现有项目
• 边缘计算场景：在 Cloudflare Workers 等受限环境部署 AI 功能的开发者
• 全栈开发者：需要快速查阅结构化输出、嵌入、多模态等高级 API 用法的工程师

使用风险

1. 依赖版本锁定：AI SDK v5 要求 Zod 3.25+，workers-ai-provider@2.x 与 v4 不兼容，版本错配会导致构建失败
2. API 成本陷阱：Gemini 工具调用会静默禁用隐式缓存，可能导致意外的高额 API 费用
3. 流式错误隐蔽：v4.1.22 之前 streamText 错误可能被静默吞没，需确保使用 onError 回调
4. TypeScript 性能：复杂 Zod schema 在顶层定义会显著拖慢类型检查，建议移至函数内部或使用 z.lazy()()
5. Provider 行为差异：不同提供商对工具调用、消息格式、错误返回的处理存在差异（如 Anthropic 的 tool-result 位置要求），跨提供商迁移需充分测试