SuperAPI AI 工具集

vercel-ai-sdk

通用与其它

查看项目

更新于 10-15 21:06

技能介绍

用途:该技能面向 Vercel AI SDK v5 的实现场景,用于在 Next.js 项目中构建 AI 聊天界面、生成或流式返回 AI 响应的 API 路由、工具调用、文本嵌入(语义搜索或 RAG)、从 v4 迁移到 v5,以及接入 Model Context Protocol(MCP)服务器。

主要能力:涵盖 generateText(非流式文本生成)、streamText(流式生成,支持 toUIMessageStreamResponse 与 toTextStreamResponse)、useChat 客户端 Hook、工具调用、embed 与 embedMany 嵌入、convertToModelMessages 消息转换,以及 experimental_createMCPClient 的 MCP 集成。

必要用法:工具调用必须从 ai 导入 tool 并使用 tool({...}) 包装,参数用 inputSchema(不是 parameters),配合 zod 定义 schema 与 execute 异步函数。v5 中 useChat 使用 sendMessage({ text: input }) 替代 append,消息内容通过 message.parts 遍历渲染。模型可用字符串形式如 'openai/gpt-4o',也兼容 openai('gpt-4o') 函数形式。嵌入使用 openai.textEmbeddingModel('text-embedding-3-small')。MCP 需安装 @modelcontextprotocol/sdk,并在 onFinish 与 onError 中关闭客户端。

依赖与限制:常见依赖包括 ai、@ai-sdk/openai、@ai-sdk/anthropic、@modelcontextprotocol/sdk、zod。安装前应先检测锁文件以选择正确包管理器(pnpm、npm、yarn 或 bun),避免生成冲突锁文件。MCP 客户端为 experimental API。资料未提供收费、价格与具体平台支持范围等信息。