跳到正文
cloudflare blog(blog.cloudflare.com)· Michelle Chen·· 2026-10-02精選品質評分77

Cloudflare 推出 Web Search API 透過 AI Gateway 提升代理人即時網頁搜尋能力

Introducing Web Search API via AI Gateway

重點導讀

Cloudflare 推出 Web Search API,讓代理人可透過 AI Gateway 直接存取即時網頁資訊。

  • 功能:支援 Ceramic.ai、Exa、Linkup 等三大搜尋提供者,並可透過 REST API 或 Workers 直接呼叫。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

推薦理由

Web Search API 讓代理人能即時抓取網頁資訊,提升模型回應的即時性與準確度,並可透過 AI Gateway 進行統一管理與計費,為開發者提供更靈活且可追蹤的資料來源。

正文 · 中文翻譯

趣事:當你使用代理且需要抓取即時網頁時,代理通常只會猜測頁面 URL,然後呼叫工具 curl。這就是為什麼你有時會看到網頁抓取回傳 404 Not Found,因為代理錯誤猜測該資訊的 URL。正如你所想,隨機猜測 URL 並不是很高效。

有更好的方法。假如你的代理實際上能瀏覽網際網路,就像人類在尋找資訊時會先使用搜尋引擎查詢一樣?這正是網頁搜尋的設計目的——它讓代理能在網路上搜尋相關資料,並以即時資訊作為回覆的基礎。

今天,我們宣佈 Cloudflare 與網頁搜尋服務商的合作夥伴關係,透過 AI Gateway 為您帶來基於即時資訊的智慧。我們將以 Ceramic.ai、Exa 和 Linkup 的合作夥伴作為此啟動的開端。

我可以用 Web Search API 做什麼?

AI 模型的效能取決於你提供的上下文。模型通常在某個時間點完成訓練並凍結,只能處理在其知識截止日期之前存在的資訊。這使得與模型討論近期事件、變動的 API 或快速演變的新聞變得相當困難。

將 Web Search API 直接整合進推論流程,能為你的代理提供動態上下文層。你的應用程式會即時取得網路上的結構化片段並直接注入上下文,讓模型能存取即時資訊。

例如,如果你的代理正在使用 Cloudflare 開發工具進行建置,它可能會錯過我們在這個 Birthday Week 釋出的所有新產品與功能!透過網頁搜尋,你可以檢索最新最優秀的檔案與釋出資訊,讓你能更快、更聰明地建置。

提升網頁搜尋的產業標準

在 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 代幣餘額扣除。我們將列出支援零資料保留 (Zero Data Retention, ZDR) 的合作夥伴,讓您確知資料不會被保留。我們亦以合作夥伴的 API 價格直接提供網路搜尋,無額外加價。 更多細節請參閱網路搜尋開發者檔案。

我們亦支援與網路搜尋供應商使用 Bring-Your-Own-Key (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 Playground使用您的 AI Gateway 帳號與金鑰進行測試。

來源: cloudflare blog (blog.cloudflare.com)
開啟原文

讀者討論

理性交流 · 即時討論