Michelle Chen、Sam Else 和 Gabriel Massadas

有趣的事实：当你使用一个智能体（Agent（智能体））并且它需要获取一个实时网页时，智能体通常只是猜测该页面的 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 的机器人爬取标准。网页搜索提供商使用的爬虫必须遵守 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"
],
},
},
}],
},
{ gateway: { id:
"default"
} },
)
const
toolCall
=
completion.tool_calls?.[
0
]
if
(toolCall?.name
===
"web_search"
) {
const
response
=
await
env.
AI
.
websearch
({
gatewayId:
"default"
,
query: toolCall.arguments.query,
limit:
5
,
})
const
searchResults
=
await
response.
json
()
const
finalResponse
=
await
env.
AI
.
run
(
model,
{
messages: [
{ role:
"user"
, content: prompt },
{
role:
"tool"
,
name:
"web_search"
,
content:
JSON
.
stringify
(searchResults),
},
],
},
{ gateway: { id:
"default"
} },
)
}

今天就试试吧！

我们非常高兴能将网页搜索引入我们的平台，并与优秀的合作伙伴一起实现这一目标，他们正在践行成为互联网良好守护者的理念。请通过 AI Gateway、独立 REST API 以及未来的其他形式试用我们全新的网页搜索工具。立即查阅我们的开发者文档开始使用，或使用您的 AI Gateway 账户和密钥在 AI Playground 上试用。

转载声明：本文为转载整理，原文版权归原作者及原站点所有。

原文来源：Cloudflare Blog

原创地址：https://blog.cloudflare.com/introducing-web-search-api/

ITPub博客

通过 AI Gateway 推出 Web Search API（应用程序编程接口）