SuperAPI AI 工具集

ai-sdk-core

智能体与模型

查看项目

更新于 10-16 02:10

技能介绍

AI SDK Core 是面向后端开发的 AI 功能技能包,基于 Vercel AI SDK v5,目标是把文本生成、结构化输出、工具调用与智能体能力接入到生产环境的后端代码中,并支持在多个模型提供商之间切换。

用途 该技能主要解决后端 AI 集成问题:以统一 API 调用不同厂商的模型,生成文本或结构化数据,定义并执行工具,从而构建更复杂的工作流与智能体。资料明确其主要方向为「Production-ready backend AI」。

主要能力

  1. 文本生成:generateText() 用于非流式文本补全,支持 prompt 或 messages 输入、system 提示、tools、maxOutputTokens、temperature、stopWhen 等选项,并可读取 result.text 与 result.usage.totalTokens。
  2. 流式文本:streamText() 提供实时文本块输出,可通过 stream.textStream 逐块消费,也可通过 stream.fullStream 获取包含元数据的完整流(如 text-delta、tool-call),或 await stream.result 获取最终结果。资料给出 Next.js API Route 中返回 stream.toDataStreamResponse() 的示例。
  3. 结构化输出:generateObject() 使用 Zod schema 生成并校验结构化对象,支持嵌套 schema、数组、enum、union 与 discriminatedUnion,返回 result.object,并区分 mode(auto/json/tool)。
  4. 流式结构化输出:streamObject() 通过 stream.partialObjectStream 输出部分对象,适合表单、仪表盘等渐进式渲染场景,并给到 useObject 客户端钩子的配合模式。
  5. 工具调用与智能体:通过 tool() 与 inputSchema(Zod)定义工具,工具包含 description 与 execute;generateText/streamText 均可传入 tools,实现多步执行与工具调用。
  6. 多提供商支持:覆盖 OpenAI、Anthropic、Google、Cloudflare Workers AI,并给出各提供商的模型标识、环境变量、常见报错及重试与限流处理方式。

使用方式 安装核心包 npm install ai、安装所需提供商包(如 @ai-sdk/openai、@ai-sdk/anthropic、@ai-sdk/google、workers-ai-provider),并安装 zod 做 schema 校验。配置对应环境变量(OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_GENERATIVE_AI_API_KEY)。随后从 'ai' 导入所需函数并从提供商包导入模型,在图示示例中直接调用。

适用场景 资料说明的适用场景包括:需要最终响应而非流式的批处理或定时任务;面向用户的实时流式响应与长文本生成;需要结构化数据(JSON、表单)且校验关键的提取与工作流;需要实时结构化数据的表单与仪表盘;以及跨提供商统一调用的多提供商场景。Cloudflare 场景下可在 Hono 处理器内延迟初始化 provider,并把复杂 Zod schema 移入路由处理器以降低启动开销。

限制 资料中未提供该技能的收费、价格、平台限制或效果保证等信息。Cloudflare Workers 使用 AI SDK v5 + Zod 时可能出现超过 270ms 的启动时间,资料建议将导入移入处理器并减少顶层 Zod schema。若为纯 Cloudflare 部署且不需要多提供商支持,资料建议改用原生 cloudflare-workers-ai 方案。各类 API Key 缺失、限流(429)、认证失败(401)、内容安全过滤、配额超限等错误需按资料给出的方式处理。