Vercel AI Gateway 新增 DeepSeek Search 与 Fetch 工具：一把密钥调用联网检索与网页读取

Vercel 于 2026 年 11 月 6 日在官方 Changelog 宣布，DeepSeek Search 与 DeepSeek Fetch 两个工具已通过 AI Gateway 开放：前者返回标题、URL 与摘要，后者把网页正文取成 Markdown。可用一把网关密钥调用，无需另开 DeepSeek 账号，并点名了 AI SDK v6 与 v7 的起始版本。

这次发布的是什么

Vercel 于 2026 年 11 月 6 日在官方 Changelog 宣布，DeepSeek Search 与 DeepSeek Fetch 两个工具已通过 Vercel AI Gateway 开放。两者分工清楚：Search 负责找到相关网页并给出标题、URL 与摘要；Fetch 负责把某个网页的正文取成 Markdown，交给模型阅读。它们被放在 AI Gateway 的工具列表里，而不是作为新模型提供，用途是给具备工具调用能力的模型补上联网检索与页面读取这两个环节。

对开发者而言，变化集中在接入侧：官方写明可以用一把 AI Gateway API 密钥同时使用这两个工具，不需要另开 DeepSeek 账号；切换模型提供方时，这两个工具可以继续沿用。版本要求也写得很具体——AI SDK 在 v6 需 6.0.321 及以后、在 v7 需 7.0.160 及以后；公告给出的升级命令是 pnpm add ai@latest，并需要设置 AI_GATEWAY_API_KEY。

可用性与限制

• 使用位置：Vercel AI Gateway，需 AI Gateway API 密钥；公告同时说明也支持自带提供方密钥
• 版本门槛：AI SDK v6 需 6.0.321 及以后，v7 需 7.0.160 及以后，升级后设置 AI_GATEWAY_API_KEY
• 模型前提：需模型支持工具调用，官方示例中的模型标识为 deepseek/deepseek-v4.1-flash-1017
• 工具边界：Search 返回标题、URL 与摘要；Fetch 返回 Markdown 正文；不承诺对任意站点都能取到内容
• 检索回退：官方给出用 exa_search、parallel_search 等工具做回退的写法，并说明回退由模型自行决定，提供方顺序与重试次数为尽力而为
• 计费口径：公告列了按请求计费与失败请求不收费的规则，具体价格与额度一律以官网为准
• 未披露：抓取范围、超时阈值、地区可用性、缓存策略与配额，公告未展开，以官方文档为准
• 境内可用性：公告未说明，实际能否从境内网络调用以官网为准

主要功能

• 用 Search 检索网页并取回标题、URL 与摘要
• 用 Fetch 把网页正文转成 Markdown 供模型读取
• 以一把 AI Gateway 密钥调用工具，无需另开 DeepSeek 账号
• 在切换模型提供方时保留同一组工具定义
• 与其他检索工具组合，写成由模型决定顺序的回退链路
• 在请求失败、超时或结果为空时不产生工具调用费用

技术原理

据官方说明，这两个工具是 AI Gateway 层的工具封装，不是模型内建的联网能力。调用方在 AI SDK 的 tools 里通过 gateway.tools.deepseekSearch 与 gateway.tools.deepseekFetch 声明工具，模型在生成过程中按工具调用协议发起请求，由 AI Gateway 去执行检索或取页，再把结果回填进上下文。公告给的示例是把两个工具一起传进 streamText，提示词写「找到某条公告、抓取它并做总结」，由模型自行决定先搜索再抓取的顺序。

Fetch 与 Search 解耦是这套设计里值得注意的一点：官方示例展示了用 exa_search 或 parallel_search 找到 URL、再交给 deepseek_fetch 读取正文的组合，并明确写出 DeepSeek Fetch 可以读取来自这些检索工具的结果 URL。也就是说，取页这一步并不绑定自家检索结果。官方同时提醒，检索回退是「模型主导」的，提供方顺序与重试次数属于尽力而为，不构成固定的故障转移保证——这决定了需要强一致重试策略的场景仍要在调用侧自己兜底。

至于 Search 的索引来源、Fetch 的正文提取与容错规则、超时与重试参数，公告没有给实现细节；本文按「以官网为准」处理，不推测底层实现。

实际体验

不做主观实测，只记录公告页可核对的观察。

一是公告给了可直接复现的最小配置：在 AI SDK 中声明工具、指定模型标识、给出提示词，然后遍历 textStream 输出。有没有生效，判断依据是模型是否在生成过程中发起了工具调用并收到网页内容，而不是看提示词写得像不像检索任务。要验证 Fetch 是否工作，可以让模型先拿到一个具体 URL 再读取它，把「检索」和「取页」两步分开观察。

二是官方主动写了降级边界：失败请求、超时与空结果不产生工具调用费用，模型 token 另计；检索回退由模型决定，顺序与重试是尽力而为。这两句合起来的意思是，把可靠性完全押在自动回退上并不稳妥，工程上仍应准备超时控制与明确的失败处理。

三是版本门槛容易被忽略：公告点名了 v6 与 v7 两条 SDK 线各自的起始版本，旧版 SDK 里并不存在 gateway.tools 这一组助手。遇到工具定义报错时，先核对 SDK 版本，比去改提示词更省事。

项目地址与获取方式

入口是 Vercel 官方 Changelog 的 2026 年 11 月 6 日条目，以及 AI Gateway 中 DeepSeek Search、DeepSeek Fetch 两个详情页；配置说明指向 AI Gateway 文档的 Web Search 章节，认证说明指向 AI Gateway API 密钥文档。命令行升级按公告给出的 pnpm add ai@latest 执行，并设置 AI_GATEWAY_API_KEY。请通过官方渠道获取，避免安装被篡改的版本。

适合谁用

• 已在用 Vercel AI SDK 与 AI Gateway 构建智能体、需要给模型补联网能力的开发者
• 希望检索与取页拆成两个可替换工具、方便更换搜索提供方的应用团队
• 不想为联网检索单独维护一套供应商账号与密钥的小型项目
• 正在评估「模型自带联网」与「网关侧工具」两种做法差异的平台工程人员
• 不必用：只做离线问答、不需要引用网页内容，或整条链路不经过 AI Gateway 的项目

常见问题

这两个工具是新模型吗？

不是。它们是 AI Gateway 提供的工具，供具备工具调用能力的模型在生成过程中调用；公告里的示例模型标识是 deepseek/deepseek-v4.1-flash-1017，工具与模型是两回事。把它写成「DeepSeek 发布了新模型」会错判事件性质。判断依据是公告把它们放在 AI Gateway 的目录下，并强调可与任意支持工具调用的模型搭配。

必须注册 DeepSeek 账号吗？

按公告说明，不需要另开 DeepSeek 账号，用一把 AI Gateway API 密钥即可调用；AI Gateway 也支持自带提供方密钥的做法。密钥的申请与权限范围以官方文档为准，本文不代填配置细节。若组织已有自己的密钥管理体系，需要核对的是网关侧的认证方式，而不是模型方的账号体系。

抓取任意网页都能成功吗？

公告没有这样承诺。它只描述 Search 返回标题、URL 与摘要、Fetch 把页面内容取成 Markdown，并说明失败请求、超时与空结果不产生工具调用费用——这本身就意味着失败是被预期到的。站点能否访问、正文能否提取、是否有反爬限制，公告未展开，以官网为准。

旧版 AI SDK 能直接用吗？

不能直接按示例使用。公告写明 v6 需 6.0.321 及以后、v7 需 7.0.160 及以后，并给出 pnpm add ai@latest 的升级命令。低于这些版本时，gateway.tools 下的助手可能不存在；先对齐版本，再排查工具定义与提示词，是更省时间的排错顺序。

相关工具与内容

站内 AI 搜索分类、AI 编程分类 与 AI 智能体分类 汇总了相关工具；DeepSeek 工具页、Perplexity 工具页 可对照检索侧选择。脉络可看 DeepSeek V4.1 Flash 发布、MiniMax M3.1 Flash 上架 AI Gateway 与 Bedrock Web Search 的地域与用户位置参数。