Cloudflare 通过 AI Gateway 推出网页搜索 API

关键信息

搜索请求会出现在标准的 AI Gateway 可观测性日志中，消耗 AI Gateway 额度，并按照提供商的 API 标准价格计费且不额外加价；Cloudflare 还会标识支持零数据保留的提供商。参与的爬虫必须遵守 Cloudflare 对 Verified bots 的要求，尊重 robots.txt 等爬虫规则，并在搜索结果中返回被抓取内容的来源链接。

资讯摘要

Cloudflare 表示，智能体通常会通过猜测网址，再调用类似 curl 的工具来获取实时网页；一旦猜错，就可能返回 404 错误。该公司认为，先搜索再获取内容的工作流更高效，因为智能体可以先向互联网查询相关信息。通过 AI Gateway 提供的新网页搜索 API，旨在将新鲜、结构化的网页摘要直接注入应用的模型上下文。这样可以弥补模型训练数据在知识截止日期后被冻结的局限，尤其适用于近期事件、不断变化的 API 和快速演变的新闻。

该服务首批接入 Ceramic.ai、Exa 和 Linkup，Cloudflare 举例称，智能体可以搜索其在活动期间发布的新产品和最新文档。Cloudflare 还表示，这些合作伙伴同意遵守其爬虫标准，包括将爬虫标识为 Verified bots、尊重 robots.txt 和网站偏好，并在响应中提供来源链接。AI Gateway 作为控制平面，为网页搜索调用提供日志记录、通过网关额度进行统一计费、安全机制和访问控制。Cloudflare 称搜索将按照提供商的 API 标准价格计费且不额外加价，同时会标识适用合作伙伴是否支持零数据保留。

资讯正文

通过 AI Gateway 推出 Web Search API

有趣的是：当你使用智能体，而它需要获取一个实时网页时，智能体通常只会猜测该页面的 URL，然后调用工具通过 curl 获取页面。这就是为什么你有时会看到网页抓取返回“404 Not Found”——当智能体错误地猜测了相关信息所在页面的 URL 时，就会发生这种情况。可以想见，总是随机猜测 URL 并不是特别高效的做法。

其实有更好的方式。如果你的智能体能够像人类查找信息时首先使用搜索引擎查询一样，真正浏览互联网，会怎么样？这正是网页搜索的用途所在——它让智能体能够在互联网上搜索相关数据，并根据实时信息为智能体的响应提供依据。

今天，我们宣布 Cloudflare 与网页搜索提供商展开合作，通过 AI Gateway 为你带来有依据的智能能力。此次发布将与我们的合作伙伴 Ceramic.ai、Exa 和 Linkup 携手开启。

Web Search API 能做什么？

AI 模型的能力取决于你提供给它们的上下文。模型通常会在某个时间点完成训练并被冻结，只能基于知识截止日期之前存在的信息运行。这使得我们很难与模型讨论近期事件、不断变化的 API 或快速发展的新闻。

将 Web Search API 直接集成到推理流程中，可以为你的智能体配备动态上下文层。你的应用能够将来自网络的最新结构化摘要直接注入上下文，从而让模型访问实时信息。

例如，如果你的智能体正在使用 Cloudflare 的开发者工具构建项目，它可能会错过我们在本次 Birthday Week 期间发布的所有新产品和新功能！借助网页搜索，你将能够获取最新、最完善的文档和发布信息，从而更快、更智能地进行构建。

提升网页搜索的行业标准

在 Cloudflare，我们认为，爬虫应当诚实、透明，并遵守所有机器人规则和偏好；网站所有者也应当能够清楚了解其内容的使用方式，并对此拥有有意义的透明度和控制权。随着今天的发布，我们很高兴地宣布，我们的合作伙伴已承诺遵守 Cloudflare 的机器人抓取标准。

网页搜索提供商使用的爬虫必须遵守我们开发者文档中所定义的、针对“Verified bots”公开声明的要求；网页搜索响应还必须包含一个指向被抓取内容所在位置的链接。这些规则有利于构建更加公平的互联网，也让创作者能够决定如何处理自己的数据。

我们非常高兴能够在确立互联网上优秀爬虫的标准方面再迈出一步，也更加为那些迎接这一挑战、与我们共同维护这些标准的网页搜索合作伙伴感到自豪。当你在 Cloudflare 上使用网页搜索时，你选择获取的是来自相关运营方的搜索知识；这些运营方致力于通过识别其爬虫、遵守 robots.txt 并提供搜索结果来源，提供有助于构建更好互联网的透明度、控制权和可见性。

通过 AI Gateway 使用 Web Search API

Cloudflare 的 AI Gateway 是我们全新 Web Search API 产品的旗舰集成入口。AI Gateway 旨在成为应用的控制平面，内置可观测性、统一计费、安全性和访问控制。很自然地，我们认为网页搜索非常适合纳入其中：你可以使用 AI Gateway 积分来调用网页搜索；收集网页搜索调用的日志和请求数据；并控制哪些人可以访问哪些网页搜索提供商。

请求会显示在你常规的 AI Gateway 可观测性日志中，而网页搜索查询所产生的费用会从你的 AI Gateway 积分余额中扣除。我们会标识支持零数据保留（Zero Data Retention，ZDR）的合作伙伴，让你知道自己的数据不会被保留。我们还直接按照合作伙伴的 API 标准价格提供网页搜索，不收取任何额外加价。更多详情请参阅网页搜索开发者文档。

我们还支持与网页搜索提供商配合使用自带密钥（Bring-Your-Own-Key，BYOK），就像对模型推理提供商所做的那样。这样，你就可以沿用现有的组织配置，只需几个简单步骤即可开始使用 AI Gateway 和网页搜索。

直接 REST API

如果你正在从现有后端、移动应用或外部服务发起 HTTP 调用，可以通过标准 REST 端点直接查询网页搜索。只需传入 AI Gateway 身份验证令牌，在请求负载中指定首选提供商，接口就会返回网页搜索结果。

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \

--request POST \

--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \

--header "Content-Type: application/json" \

--data '{

"query": "What are some fun things to do in Salt Lake City as fall approaches?",

"provider": "ceramic",

"limit": 5,

"options": {

"gateway": { "id": "default" }

}

}'

Workers 绑定

对于直接在 Cloudflare Workers 上构建应用的开发者来说，集成只需一行代码。我们还提供了独立的 Worker 绑定，你可以用它为自己的代理执行网页搜索：

const response = await env.AI.websearch({

gatewayId: "default",

query: "What are some fun things to do in Salt Lake City as fall approaches?",

provider: "exa",

limit: 5,

})

const results = await response.json()

即将推出：服务器工具

我们正在积极地将原生服务器工具直接构建到 AI Gateway 中。很快，你将无需自行定义工具：它们会内置于我们的控制平面中，让你可以把更多时间用于构建，而不是编排工具运行框架。网页搜索将成为我们纳入服务器工具体系的首批工具之一，我们非常期待你来试用。

不过，如果你希望现在就自行将网页搜索编排为服务器工具，可以使用下面的 Worker 代码片段轻松实现：

const completion = await env.AI.run(

"@cf/google/gemma-4-26b-a4b-it",

{

messages: [{ role: "user", content: "What happened in the last Cloudflare Birthday Week in 2025?" }],

tools: [{

type: "function",

function: {

name: "web_search",

description: "Search the web for current information.",

parameters: {

type: "object",

properties: { query: { type: "string" } },

required: ["query"],

},

}],

```js

{ gateway: { id: "default" } },

const toolCall = completion.tool_calls?.[0]

if (toolCall?.name === "web_search") {

query: toolCall.arguments.query,

const searchResults = await response.json()

const finalResponse = await env.AI.run(

model,

messages: [

{ role: "user", content: prompt },

role: "tool",

content: JSON.stringify(searchResults),

```

立即试用！

我们很高兴能将网页搜索带到我们的平台，并与致力于践行互联网良好管理理念的优秀合作伙伴携手完成这项工作。欢迎通过 AI Gateway、独立的 REST API，以及未来推出的其他形式，试用我们的全新网页搜索工具。立即查看我们的开发者文档开始使用，或者使用你的 AI Gateway 账户和密钥，在 AI Playground 中体验。

来源与参考

1. 原始链接
2. Introducing Web Search API via AI Gateway