Cloudflare 通过 AI Gateway 推出 Web Search API

用途与变化

Cloudflare 于 2026 年 10 月 2 日发布公告，宣布通过 AI Gateway 提供 Web Search API，首发合作方为 Ceramic.ai、Exa 和 Linkup。其出发点是：智能体在需要获取实时网页时，常靠猜测 URL 再调用工具抓取，容易返回 404；改为先做搜索再取回相关结果，可把动态的、结构化的网页片段注入模型上下文，缓解模型知识截止导致无法处理近期事件、API 变化和快速演进新闻的问题。

接入方式

• 直接 REST 调用：向 Cloudflare 账户下的 websearch 端点 POST 请求，携带 AI Gateway 令牌，在载荷中指定 provider 与返回条数，可选 gateway 配置。
• Workers 绑定：在 Cloudflare Workers 中通过 env.AI.websearch 调用，指定 gatewayId、query、provider 和 limit。
• 自建工具：官方也给出把 web search 定义为函数工具、先由模型产生 tool call 再调用搜索、并把结果回填为 tool 消息的示例流程。

计费与治理

搜索请求会出现在 AI Gateway 的可观测性日志中，消耗 AI Gateway 额度；官方称按合作方列表价提供、不额外加价，并会标注支持零数据留存（ZDR）的合作方。同时支持自带密钥（BYOK）。合作方承诺遵守 Cloudflare 对“已验证机器人”的抓取要求，搜索结果需包含被抓取内容的来源链接，并识别爬虫、遵守 robots.txt。

限制与待核实

来源未给出具体价格、速率限制、各合作方能力差异或搜索结果结构细节；服务器端内置工具（Server Tools）尚在开发中，Web 搜索将是首批纳入的工具，目前需自行编排。相关文档与定价需以官方开发者文档为准。