Michael Johnson2026 年 10 月 2 日，Cloudflare 通过 AI Gateway 推出了 Web Search API，这是面向 AI 智能体和应用的网页搜索接口。首批接入的服务商包括 Ceramic.ai、Exa 和 Linkup。经核实，截至 10 月 8 日，官方概览文档（更新于 10 月 2 日）将该产品标注为公开测试版。
对开发者而言，最重要的变化是可以将搜索接入现有的模型工作流。根据AI Gateway 集成说明，搜索请求与模型请求共用日志、分析、账单和访问控制功能。因此，搜索可以作为智能体执行任务过程中一个独立且可观测的环节。
智能体为何需要搜索
在Cloudflare 的发布公告中，公司指出了一个实际问题：智能体可能会猜测目标页面的地址，随后对错误 URL 发起的请求就会返回 404。搜索工具提供了另一种可行路径：构造查询、获取相关资料的网址，并利用搜索到的信息生成回答。
第二种应用场景是处理模型训练完成后发生的变化。Cloudflare 特别提到最新事件、不断变化的 API，以及新发布的工具。对于帮助编写代码的智能体，搜索特定版本库的文档或新出现的参数可能很有用。在这个过程中，搜索负责提供上下文材料，而应用决定将哪些结果传给模型。
给团队的实用建议是：将找到的内容片段、对应 URL 和查询语句一起保存。这样在核查回答时，就能还原智能体依据的是哪份资料。处理版本相关任务时，也可以在搜索语句中明确写出产品名称和所需版本。
如何接入新 API
文档介绍了两种调用方式：从外部后端调用 REST API，或在 Cloudflare Workers 中使用 AI binding。通过 provider 参数选择服务商。三家服务都会以统一格式返回结果，包括标题、URL 和摘要。这让应用处理响应的部分更容易切换服务商。
统一格式便于开发者构建自己的搜索工具适配器。适配器的任务是接收智能体的查询、调用所选服务商，并将筛选后的结果传给模型。在应用层面，还应单独决定何时只需使用搜索结果中的摘要，何时需要读取找到的网页并核实具体说法。
Cloudflare 在发布公告中将 AI Gateway 内置的服务器端工具列为未来功能，并表示网页搜索将成为首批此类工具之一。发布时展示的方案仍需自行编排：处理工具调用，并将搜索结果传入下一次模型请求。
哪些条件已经确认
根据文档中的付费说明，用户可以使用 AI Gateway 额度，按照相应服务商公开的 API 价格支付请求费用，Cloudflare 不额外加价。也支持 Bring Your Own Key，即使用自己的搜索服务商 API 密钥。若选择这种方式，团队应提前确定如何追踪用量并核对账单。
经核实，发布公告和概览页面均未列出具体价格或请求数量配额。因此，应在核查所选服务商的费率后再估算集成预算。验收测试可围绕自身任务设计，重点衡量合适来源的比例、响应时间、每项已完成任务的搜索请求数量，以及错误处理情况。
数据留存也是需要关注的一项。Cloudflare 在零数据留存（ZDR）说明中承诺，会标明支持 ZDR 的合作伙伴。对于具体的搜索路由，应单独核实服务商的数据留存条件和 AI Gateway 的日志设置：公告同时确认，搜索请求会记录在可观测性系统中。
服务商还承诺遵守Cloudflare 对 Verified bots 的要求：标识自己的机器人、遵循 robots.txt 和爬取指令、保持合理的请求频率，并尊重网站所有者的偏好。Web Search API 概览还确认，每项搜索结果都必须附带来源链接。
对开发者来说，此次发布提供了一个明确的接入点，可将网页搜索连接到智能体，并统一记录其使用情况。评估时可以从少量真实任务开始，明确选择服务商，并在回答中保留链接。正是这些决策，将决定搜索到的资料能否帮助应用完成具体工作。