# Cloudflare 推出 Web Search API：通过 AI Gateway 为智能体提供网页搜索

https://jsonscraper.com/zh/blog/cloudflare-web-search-api-ai-agents

Author: Michael Johnson

Published: 2026-10-08T06:21:44+00:00

Updated: 2026-10-08T06:34:05+00:00

公开测试版整合了三家搜索服务商，并提供请求记录与付费功能。搜索编排仍由应用负责。

2026 年 10 月 2 日，Cloudflare 通过 AI Gateway [推出了 Web Search API](https://blog.cloudflare.com/introducing-web-search-api/)，这是面向 AI 智能体和应用的网页搜索接口。首批接入的服务商包括 Ceramic.ai、Exa 和 Linkup。经核实，截至 10 月 8 日，[官方概览文档](https://developers.cloudflare.com/web-search/)（更新于 10 月 2 日）将该产品标注为公开测试版。



![Cloudflare 推出 Web Search API：通过 AI Gateway 为智能体提供网页搜索
背景：2026 年 10 月 2 日，Cloudflare 通过 AI Gateway 推出 Web Search API。本文介绍已确认的接入方式、结果格式、付费条件，以及已公布功能的范围。
画面主体：写实风格的编辑类照片，展示开发者的工作站：笔记本电脑屏幕上显示抽象的网页搜索结果和结构化 API 数据，带有微妙的橙色灯光，无标志、无可读文字](https://jsonscraper.com/assets/uploads/journal/2026/10/daad7cbd19f04c9c9d5ed6c4c370ab46.png.hero.webp)

© jsonscraper · AI 生成图像

 

对开发者而言，最重要的变化是可以将搜索接入现有的模型工作流。根据[AI Gateway 集成说明](https://developers.cloudflare.com/web-search/)，搜索请求与模型请求共用日志、分析、账单和访问控制功能。因此，搜索可以作为智能体执行任务过程中一个独立且可观测的环节。

 

## 智能体为何需要搜索

 

在[Cloudflare 的发布公告](https://blog.cloudflare.com/introducing-web-search-api/)中，公司指出了一个实际问题：智能体可能会猜测目标页面的地址，随后对错误 URL 发起的请求就会返回 404。搜索工具提供了另一种可行路径：构造查询、获取相关资料的网址，并利用搜索到的信息生成回答。

 

第二种应用场景是处理模型训练完成后发生的变化。Cloudflare 特别提到最新事件、不断变化的 API，以及新发布的工具。对于帮助编写代码的智能体，搜索特定版本库的文档或新出现的参数可能很有用。在这个过程中，搜索负责提供上下文材料，而应用决定将哪些结果传给模型。

 

给团队的实用建议是：将找到的内容片段、对应 URL 和查询语句一起保存。这样在核查回答时，就能还原智能体依据的是哪份资料。处理版本相关任务时，也可以在搜索语句中明确写出产品名称和所需版本。

 

## 如何接入新 API

 

文档介绍了[两种调用方式](https://developers.cloudflare.com/web-search/)：从外部后端调用 REST API，或在 Cloudflare Workers 中使用 AI binding。通过 `provider` 参数选择服务商。三家服务都会以统一格式返回结果，包括标题、URL 和摘要。这让应用处理响应的部分更容易切换服务商。

 

统一格式便于开发者构建自己的搜索工具适配器。适配器的任务是接收智能体的查询、调用所选服务商，并将筛选后的结果传给模型。在应用层面，还应单独决定何时只需使用搜索结果中的摘要，何时需要读取找到的网页并核实具体说法。

 

Cloudflare 在[发布公告](https://blog.cloudflare.com/introducing-web-search-api/)中将 AI Gateway 内置的服务器端工具列为未来功能，并表示网页搜索将成为首批此类工具之一。发布时展示的方案仍需自行编排：处理工具调用，并将搜索结果传入下一次模型请求。

 

## 哪些条件已经确认

 

根据[文档中的付费说明](https://developers.cloudflare.com/web-search/)，用户可以使用 AI Gateway 额度，按照相应服务商公开的 API 价格支付请求费用，Cloudflare 不额外加价。也支持 Bring Your Own Key，即使用自己的搜索服务商 API 密钥。若选择这种方式，团队应提前确定如何追踪用量并核对账单。

 

经核实，发布公告和概览页面均未列出具体价格或请求数量配额。因此，应在核查所选服务商的费率后再估算集成预算。验收测试可围绕自身任务设计，重点衡量合适来源的比例、响应时间、每项已完成任务的搜索请求数量，以及错误处理情况。

 

数据留存也是需要关注的一项。Cloudflare 在[零数据留存（ZDR）说明](https://blog.cloudflare.com/introducing-web-search-api/)中承诺，会标明支持 ZDR 的合作伙伴。对于具体的搜索路由，应单独核实服务商的数据留存条件和 AI Gateway 的日志设置：公告同时确认，搜索请求会记录在可观测性系统中。

 

服务商还承诺遵守[Cloudflare 对 Verified bots 的要求](https://developers.cloudflare.com/bots/concepts/bot/verified-bots/)：标识自己的机器人、遵循 `robots.txt` 和爬取指令、保持合理的请求频率，并尊重网站所有者的偏好。Web Search API 概览还确认，每项搜索结果都必须附带来源链接。

 

对开发者来说，此次发布提供了一个明确的接入点，可将网页搜索连接到智能体，并统一记录其使用情况。评估时可以从少量真实任务开始，明确选择服务商，并在回答中保留链接。正是这些决策，将决定搜索到的资料能否帮助应用完成具体工作。
