Introducing Web Search API via AI Gateway

通过 AI Gateway 引入 Web Search API | Cloudflare 博客

post

开发者平台

AI

AI Gateway

生日周

2026 年 10 月 2 日

通过 AI Gateway 引入 Web Search API

Michelle Chen、Sam Else 和 Gabriel Massadas

5 分钟阅读

复制链接

有趣的是，当代理需要获取实时网页时，通常会直接猜测页面的 URL，然后调用 curl 工具进行访问。这就是为什么有时你会看到网页抓取返回 404 Not Found 错误——当代理错误地猜测了信息的 URL 时就会发生这种情况。可想而知，随机猜测 URL 并不是特别高效的方式。

有一种更好的方法。如果代理可以像人类查找信息时从搜索引擎开始一样，实际浏览互联网会怎样？这就是网络搜索的设计初衷——它使代理能够搜索互联网上的相关信息，并基于实时信息构建代理的响应。

今天，我们宣布 Cloudflare 与网络搜索提供商合作，通过 AI Gateway 为用户提供基于事实的智能服务。我们与 Ceramic.ai、Exa 和 Linkup 的合作伙伴共同启动了这一发布。

我可以使用 Web Search API 做什么？

AI 模型的表现取决于你为其提供的上下文。模型通常在某个时间点进行训练并冻结，仅基于其知识截止日期之前存在的信息进行操作。这使得与模型讨论近期事件、变化的 API 或快速发展的新闻变得非常困难。

将 Web Search API 直接集成到你的推理流程中，可以为代理提供动态的上下文层。你的应用将能够直接从上下文中注入来自网络的新鲜、结构化片段，使你的模型能够访问实时信息。

例如，如果代理正在使用 Cloudflare 开发者工具进行构建，它可能会错过我们在本次生日周发布的所有新产品和功能！通过网络搜索，你将能够获取最新、最全面的文档和发布信息，从而更快速、更智能地进行开发。

提升网络搜索的行业标准

在 Cloudflare，我们认为爬虫应保持诚实、透明，并尊重所有机器人规则和偏好，网站所有者应对其内容的使用方式拥有有意义的透明度和控制权。今天，我们很高兴宣布我们的合作伙伴承诺遵守 Cloudflare 的机器人爬取标准。网络搜索提供商使用的爬虫必须符合我们在开发者文档中定义的“已验证机器人”的公开要求，并且网络搜索响应必须包含爬取内容的位置链接。这些规则对公平的互联网是积极的，使创作者能够决定如何处理自己的数据。

我们非常兴奋能够再次迈出一步，为互联网上良好爬虫的标准设定标杆，并为那些接受挑战与我们共同维护这些标准的网络搜索合作伙伴感到无比自豪。当你在 Cloudflare 使用网络搜索时，你选择从那些致力于提供透明度、控制权和可见性的操作员那里获取搜索知识，这些操作员通过识别其爬虫、遵守 robots.txt 规则以及提供搜索结果来源，帮助构建更好的互联网。

通过 AI Gateway 使用 Web Search API

Cloudflare 的 AI Gateway 是我们全新 Web Search API 产品的旗舰集成入口。AI Gateway 的设计目标是成为应用程序的控制平面，内置可观测性、统一计费、安全性和访问控制功能。自然地，我们认为网络搜索正好契合这一定位：您可以通过 AI Gateway 的积分使用网络搜索服务；收集网络搜索调用的日志并获取相关数据；并控制谁可以访问哪些网络搜索提供商。

网络搜索请求会显示在您的 AI Gateway 常规可观测性日志中，网络搜索查询会从您的 AI Gateway 积分余额中扣除。我们将识别支持零数据保留（ZDR）的合作伙伴，以便您明确知晓自己的数据不会被保留。我们还与合作伙伴直接以清单 API 定价提供网络搜索服务，不收取任何额外溢价。更多详情请参阅网络搜索开发者文档。

我们还支持与网络搜索提供商使用自带密钥（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
()

#### 即将推出：服务器工具

我们正在积极将原生 Server Tools 直接集成到 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

• Michelle Chen

• Sam Else

电子邮件订阅