@ai-sdk/provider
Vercel AI SDK 生态中定义模型提供者统一接口的抽象包,规定语言模型、嵌入模型等应实现的标准方法签名,使上层 SDK 可用同一套代码调用不同厂商的模型
核心事实
时间轴 (近 90 天)
对于使用 `@ai-sdk/typesafe-ai` 的项目,建议升级后运行现有的类型检查和集成测试,确认 provider 接口的兼容性没有意外漂移。
建议在升级时检查 provider 和 provider-utils 是否被其他依赖锁定在旧版本,必要时使用 overrides 或 resolutions 字段统一版本,避免同一进程内加载多份 provider-utils。
当 provider 的主版本跨越时,自定义 provider 或直接依赖底层类型的代码可能需要适配。
@ai-sdk/provider 和 @ai-sdk/provider-utils 的更新通常包含底层协议的调整、工具函数的优化或安全补丁。
@ai-sdk/vue 发布了 4.0.149 版本。
跨包混用旧版本的 @ai-sdk/provider 或 @ai-sdk/provider-utils 可能导致 finish part 解析不一致。
三个包之间存在严格的依赖链:适配器依赖 openai-compatible,openai-compatible 又依赖 provider 与 provider-utils。
在 npm 生态中,@ai-sdk/voyage 自身并不直接实现 HTTP 请求和参数校验,而是依赖 @ai-sdk/provider 提供的接口约定和 @ai-sdk/provider-utils 提供的共享工具。
若项目中同时存在多个版本的 @ai-sdk/provider 副本,可能导致类型定义不一致、instanceof 判断失效或重复打包等问题。
排查依赖版本问题可使用 npm ls @ai-sdk/provider 查看依赖树,并通过包管理器的 overrides/resolutions 字段统一版本。
还有 40 条时间轴事件
全部知识事实 (20)
@ai-sdk/provider-utils 承担 AI SDK 中与模型提供商交互的通用工具函数职责,包括流式响应解析、工具调用格式化、错误处理等底层逻辑
90%已验证@ai-sdk/provider 定义了标准接口,@ai-sdk/provider-utils 提供公共工具函数,各具体供应商包实现各自的适配逻辑
90%已验证@ai-sdk/vue是Vercel AI SDK面向Vue.js框架的官方适配层,为Vue开发者提供声明式API用于集成大语言模型能力,包括流式响应处理、聊天界面状态管理、工具调用等场景
90%已验证升级 @ai-sdk/voyage 时建议同步更新 @ai-sdk/provider 与 @ai-sdk/provider-utils 以确保依赖树版本对齐
90%已验证@ai-sdk/zai@3.0.8 同步更新了上游依赖:@ai-sdk/provider@4.0.12、@ai-sdk/openai-compatible@3.0.46、@ai-sdk/provider-utils@5.0.38
90%已验证AI SDK 采用 Provider 架构,每个 Provider 包实现 LanguageModelV1 等标准化接口,这是策略模式的工程实践
90%已验证Vercel AI SDK 提供统一的抽象接口(如 generateText、streamText),使开发者调用不同模型供应商时代码风格保持一致
90%已验证Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式,核心包 ai 与各框架适配包(如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte)协同发布
90%已验证Vercel AI SDK提供了流式响应、工具调用和多模型适配的统一抽象层
90%已验证@ai-sdk/provider包定义了所有提供商必须实现的核心接口契约,包括文本生成、流式输出、工具调用等能力的标准化定义
85%已验证由于大模型 API 迭代频繁,@ai-sdk/provider 和 @ai-sdk/provider-utils 在 AI SDK 工具链中发布频率较高
80%已验证AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
80%已验证Vercel AI SDK 的多厂商统一抽象层基于 Provider 插件机制实现,每个厂商适配器负责将该厂商的原始 HTTP API 转换为 SDK 内部标准的 LanguageModelV1 接口
80%已验证本次更新将依赖 ai 升级到 7.0.102,将 @ai-sdk/provider-utils 升级到 5.0.41
80%已验证@ai-sdk/zai模块依赖于provider、openai-compatible和provider-utils等基础模块
80%已验证若项目中同时存在多个版本的 @ai-sdk/provider 副本,可能导致类型定义不一致、instanceof 判断失效或重复打包等问题。
75%已验证如果项目里 @ai-sdk/vue 和 ai 的版本没有对齐,可能会出现类型不匹配或运行时行为差异。
75%已验证在 monorepo 结构中,适配包若不同步更新依赖声明,可能导致依赖树中出现两份 provider-utils 或类型定义不匹配的问题。
75%已验证@ai-sdk/provider 定义了统一的 TypeScript 接口,如 LanguageModelV1、EmbeddingModelV1,使上层应用无需关心底层供应商实现细节
75%已验证当 @ai-sdk/provider-utils 这类被多个包共同依赖的基础层包更新时,Changeset 会自动将依赖它的包标记为 patch 版本升级,这是 @ai-sdk/valibot 自身代码无变化却仍发布新版本的原因
75%