AI 模型的表现取决于你提供的上下文。模型在某个时间点训练完成后即被冻结，因此它们只了解知识截止日期之前存在的信息。这让模型难以处理近期事件、变化中的 API 或快速变化的新闻。
没有网络搜索时，需要实时信息的 Agent 通常会猜测页面 URL 并直接抓取。猜测错误时，请求会返回 404 Not Found，Agent 只能再试一次。
Web Search API 为 Agent 提供了更好的选择。就像人们从搜索引擎开始一样，Agent 发送查询后会收到相关且最新的结果列表。你可以将这些结果注入模型上下文，使其回复建立在实时信息之上。
发送搜索请求时，Web Search API 会：
- 通过你指定的 AI Gateway 路由请求。
- 将查询转发给你选择的搜索提供商 — Ceramic.ai、Exa 或 Linkup。如果未设置提供商，Web Search API 默认使用 Ceramic.ai。
- 将提供商的响应规范化为一致格式，每条结果包含 URL、标题，以及可选的描述、图片、favicon 和上次修改日期。
- 在 AI Gateway 日志中记录该请求，并向你的账户计费。
由于每个提供商都返回相同的结果格式，你只需更改一个参数即可切换提供商。
Web Search API 建立在 AI Gateway 之上，后者充当 AI 应用的控制平面。每次搜索请求都会经过网关，从而为你提供：
- 可观测性 — 搜索请求会与模型推理请求一起出现在网关的日志和分析中。
- Unified Billing — 搜索会从你的 AI Gateway 额度余额中扣减。你按各提供商的目录 API 价格付费，不加价。费率请参阅提供商。
- 自带密钥 (BYOK) — 如果你已有搜索提供商账户，可以在网关上存储提供商 API 密钥。提供商会直接向你计费。
- 访问控制 — 控制网关可以使用哪些提供商，以及谁可以发送请求。
Cloudflare 认为抓取程序应当诚实透明，并尊重站点所有者设置的规则与偏好。站点所有者应能清晰了解并控制其内容的使用方式。
每个 Web Search API 提供商都承诺满足以下标准：
- 已验证机器人合规 — 提供商使用的抓取程序必须满足 Cloudflare 公布的已验证机器人要求。这包括标识抓取程序并遵守
robots.txt。 - 来源归属 — 每条搜索结果都必须包含指向所抓取内容位置的链接。
当你使用 Web Search API 时，Agent 会消费来自这些运营商的搜索结果，这些运营商为站点所有者提供内容抓取方面的透明度、控制权和可见性。