Cloudflare 通过 AI Gateway 推出 Web Search API

有趣的事实：当你使用智能体（agent）且它需要获取实时网页时，智能体通常只是猜测网页的 URL，然后调用工具去 curl 它。这就是为什么你有时会看到网页获取返回 404 Not Found，这发生在该智能体错误地猜测了该信息的 URL 时。你可以想象，一直随机猜测 URL 并不是非常高效。

有一种更好的方法。如果你的智能体真的可以浏览互联网，就像人类在寻找信息时从搜索引擎查询开始一样，会怎样呢？这就是网页搜索（web search）的设计初衷——它使智能体能够在互联网上搜索相关数据，并基于实时信息为智能体的回答提供依据。

今天，我们宣布 Cloudflare 与网页搜索提供商建立合作伙伴关系，通过 AI Gateway 为你带来基于事实的智能。我们首先与 Ceramic.ai、Exa 和 Linkup 的合作伙伴共同启动了此次发布。

我可以用 Web Search API 做什么？

AI 模型的好坏取决于你提供给它们的上下文。模型通常在训练后就会在某个时间点被冻结，仅在知识截止日期之前存在的信息上运行。这使得与模型讨论近期事件、不断变化的 API 或快速发展的新闻变得相当困难。

将 Web Search API 直接集成到你的推理管道中，可以为你的智能体配备一个动态上下文层。你的应用程序可以直接将来自网络的最新、结构化的片段注入到上下文中，从而使你的模型能够访问实时信息。

例如，如果你的智能体是使用 Cloudflare 开发人员工具构建的，它可能会错过我们在这次 生日周 期间发布的所有新产品和功能！有了网页搜索，你将能够检索到最新、最棒的文档和发布内容，从而构建得更快、更智能。

提升网页搜索的行业标准

在 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 额度余额中扣除。我们将标识支持零数据保留（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()

即将推出：服务器工具

我们正在积极将原生服务器工具直接构建到 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 上进行体验。