Microsoft Web IQ 常見問題

關於使用 Microsoft Web IQ 常見問題解答。 關於 API 細節與請求範例,請參閱 API 參考文獻。

服務與部署

什麼是 Microsoft Web IQ?

Microsoft Web IQ 是一套 AI 原生的網頁搜尋與 grounding API,讓大型語言模型(LLM)、人工智慧代理(AI agent)及應用程式能存取當前且相關的網路資訊。 這讓 AI 回答更準確、最新,並附有使用者可驗證的來源。 Web IQ 驅動著領先的前沿 AI 助理,包括 Microsoft Copilot 和 ChatGPT。

Web IQ 可透過 REST https://api.microsoft.ai/v3 及 MCP https://api.microsoft.ai/v3/mcp取得。 每個 Web IQ AppID 可呼叫網頁搜尋、新聞、圖片、影片、瀏覽、地點及 Auto(自 2026 年 11 月 17 日起)。

什麼是 Web grounding?AI 代理什麼時候需要它?

Web grounding 讓 AI 能存取最新的網路資訊,使其能利用訓練資料以外的最新事實回答,並附有引用來源供使用者查證。 它最有助於處理經常變動的資訊,例如市場發展、競爭者動態、新聞及法規更新。

Web IQ 是 LLM 嗎? 它會產生最終答案嗎?

No. Web IQ 不是 AI 模型或大型語言模型(LLM)。 這是一套 AI 原生的網路搜尋與 Grounding API,讓大型語言模型(LLM)、人工智慧代理和應用程式能存取當前且相關的網路資訊。

Web IQ 不會產生最終的 AI 答案。 它從網路上擷取相關資訊,而你選擇的大型語言模型、AI 代理或應用邏輯會利用這些證據產生回應。

Web IQ 與其他網路搜尋 API 及基礎服務有何不同?

大多數網路搜尋 API 都迫使我們做出取捨:快速或準確、成本效益或完整。 根據 Microsoft 公布的比較,Web IQ 提供最高的依據滿意度、最快的速度以及每次查詢最少的代幣數。 這也是 Copilot 和 ChatGPT 等 AI 助理每天都依賴的平台,經過全球驗證,並可供任何 AI 代理程式或應用程式建構於其上。

Web IQ 的不同之處也在於其存取內容的方式。 它採取負責任的網路存取方式,結合開放網路與結構化資料,並內建企業級的安全與防護。

Web IQ 是搭配你已經使用的 AI 技術棧運作的。 你可以使用你偏好的 AI 模型,並透過 REST API 或模型上下文協定(MCP)連接,而不必綁定於單一模型或平台。

資料來源: Web IQ 基準測試結果 (品質、效率與速度部分)。

我可以用 Web IQ 建立什麼?

Web IQ 驅動需要來自公開網路新鮮外部資訊的 AI 代理與應用程式。 內部團隊可以用它來進行競爭情報、監控、法規研究、銷售情報及內容優化。 面向客戶的體驗可以利用它用於研究、探索、推薦及專門代理。

它最適合資訊頻繁變動、跨越多個外部來源,且需要以當前且可歸屬的網路內容為基礎的情況。

哪一款 Web IQ API 最適合我的使用情境?

使用 Web Search API 尋找與模型相關的公開頁面和段落,使用 News API 處理時事,使用 Images and Videos API 提供視覺與影片結果,使用 Places API 提供結構化的地點資訊,當你已知網址時,使用 Browse API 。 請參考 API 參考,了解你帳戶可用的功能和限制。

我可以搭配現有的 AI 模型和代理框架使用 Web IQ 嗎?

Yes. Web IQ 讓你能將網路資訊加入你選擇的 AI 模型和代理工作流程中。 REST API 和 MCP 讓你在如何連接它這件事上有彈性。 請查看 SDK 與 MCP 整合文件 以了解支援的設定。

整合會是什麼樣子?

你的 AI 代理或應用程式會呼叫 Web IQ 取得網路證據,然後將選取的結果傳給模型以產生回應。 您可以控制資訊的選擇、使用與引用方式。 依照 快速入門 連接你的第一個工作流程,或 開始使用 Playground。

Web IQ 能取得公司的機密資訊嗎?

No. Web IQ 可擷取公開網路資訊。 在企業情境方面,Microsoft 提供 Work IQ、Fabric IQ 和 Foundry IQ,各自扮演不同角色,從組織情境到商業數據與企業知識。

Web IQ 與 Foundry IQ、Work IQ 以及 Fabric IQ 有何關聯?

Microsoft IQ 整合了四個整合層級,驅動涵蓋整個 Microsoft 的企業智慧。 Web IQ 提供來自公開網路的資訊。 Work IQ 著重於工作訊號,Fabric IQ 著重於商業數據,Foundry IQ 則著重於組織知識。 這些產品滿足 AI 代理與應用的不同資訊需求,且結合使用時最為強大。

Web IQ 是 Azure 資源嗎?

你在 Azure 訂閱中部署了一個 Web IQ 資源。 該資源負責計量與計費。 你應用程式在 Web IQ 中的身份是其 Web IQ AppID,當你在 Web IQ 開發者入口網站連接資源時所建立。

該服務本身由 Microsoft 託管,且為多租用戶架構。 Web 擷取與排名在 Microsoft 基礎結構中執行,而您的應用程式則透過 HTTPS 呼叫 api.microsoft.ai。 Azure 資源不承載 Web IQ,也不在請求路徑中。

Web IQ 資源和 Web IQ AppID 有什麼差別?

Web IQ 資源是你在Azure訂閱、Azure入口網站或Azure CLI中建立的Azure資源。 Web IQ 的使用量會被計量,並透過你的訂閱計費。 資源不在請求路徑中:你的應用程式是直接呼叫 api.microsoft.ai 的。

Web IQ AppID 是你應用程式在 Web IQ 中的身份。 當你在 Web IQ 開發者入口網站中連結 Web IQ 資源時,它就會建立。 應用程式如何使用 Web IQ 的所有資訊都設定在 AppID 上:可呼叫哪些 API、速率限制(預設為 15 QPS)、API 金鑰,以及綁定在 App ID 上的 Entra 應用程式(客戶端)ID。 不要把它和你應用程式註冊時的 Entra 應用程式(客戶端)ID 搞混:那個 ID 會在你的應用程式取得權杖時,向 Microsoft Entra ID 識別你的應用程式,並將其綁定到 Web IQ AppID。

連接資源會產生一個 AppID,因此大多數客戶一開始都會先建立各一個。 如果你需要多個 AppID,例如每個環境或工作負載一個,你的 Microsoft 聯絡人可以告訴你選項。

Web IQ 部署在哪裡?

Web IQ 由 Microsoft 託管,並透過公開https://api.microsoft.ai/v3端點提供。 你的應用程式呼叫 API,而 Web IQ 則在伺服器端執行網頁檢索。

有沒有專門針對金融、體育或天氣的 API?

沒有專門的金融、體育或天氣 API。 對於天氣,當查詢關於天氣時, 自動 會回傳結構化天氣結果(當前狀況、每日預報及有效天氣警報,並附有發布權威的連結)。 對於財經、體育及其他主題,請使用網路搜尋,它會以非結構化頁面文字而非結構化訂閱回傳相關爬取內容。

存取與導入

我該如何從評估轉到正式環境?

  1. 完成評估並確認服務符合您的需求。
  2. 在付費的 Azure 訂閱中建立一個 Web IQ 資源,然後登入 Web IQ 開發者入口網站並連接該資源。 這會建立你的正式版 AppID,你可以從設定檔管理複製。 它從預設的每秒 15 次查詢(QPS)開始。
  3. 要用 Microsoft Entra ID 認證,請在開發者入口網站將你的應用程式註冊的 Entra 應用程式(用戶端)ID 綁定到該 AppID。

您使用 Web IQ 的行為受 Web IQ 使用條款規範,並依據您現有的 Microsoft 客戶合約 進行。

我可以使用哪些 Azure 訂閱?

Web IQ 需要付費的 Azure 訂閱,包括透過 雲端解決方案提供者(CSP)合作夥伴購買的訂閱。 Visual Studio、免費試用、學生訂閱和 Azure 額度都無法用於 Web IQ。 如果因 Azure 帳戶狀態而無法建立 Web IQ 資源,錯誤訊息會要求您聯絡 Microsoft 帳戶 團隊,他們可以申請審查。

我的應用程式可以呼叫哪些 API?

每個 Web IQ AppID 都可以呼叫 Web 搜尋、新聞、圖片、影片、瀏覽、地點,以及自 2026 年 11 月 17 日起的 Auto。如果在該日期之後 Allowed Services 中沒有列出 Auto,請使用您的 AppID 開啟 Web IQ 支援請求。 要查看你的 AppID 可以呼叫哪些 API,請登入 Web IQ 開發者入口網站,前往 設定檔管理,在左上角下拉選單中依名稱選擇你的 AppID,然後勾選 允許服務。

我要如何取得商務 API 的存取權?

商務 API(搜尋、優惠與產品詳情)目前僅限部分 Azure 客戶預覽。 預覽期間我們會擴大存取權限;存取權並非保證。 若要申請存取權限,請開啟 Web IQ 支援請求,選擇「認證與存取」作為問題類型,並附上你的 AppID,或是如果你還沒有 AppID,則附上你的公司名稱以及你的 Web IQ 資源名稱。 Commerce 使用量按每次呼叫計費;詳見定價。 關於 API 參考,請參見 Commerce。

Commerce API 能做什麼? 這些 API 支援結帳嗎?

共有三個 Commerce API。 搜尋會將產品查詢轉換成經排序的商品,每項商品都有賣家報價(價格、賣家、報價連結、圖片、運送資訊及狀況)。 Offers 從搜尋結果中回傳符合資格的賣家對單一產品的報價。 產品詳情會回傳產品的標題、描述及平均評分。 Commerce API 不支援結帳、付款或其他交易:它們會回傳商品和優惠資訊,並附上商家的每個優惠連結。

無論是使用者,或是代表使用者行事的代理人,每次連結至或導覽至該優惠時,都必須使用各優惠的 clickUrl,且必須與該回應中傳回的內容完全一致。 不要刪減、重寫、縮短或重複使用它,也不要連結到 displayUrl,因為它只會識別商家或賣家。 只有當它能不修改地通過原始連結時,才能將它包裹 clickUrl 在自己的追蹤連結中。 在應用程式代碼中,從回應建立每個連結,而不是讓模型重現它。 詳情請參閱 提供連結與歸屬及 Web IQ 使用條款的附件 B。

我應該用哪個電子郵件地址登入?

請使用有權限存取 Web IQ 的 Microsoft 登入地址:即 Microsoft 為你啟用的地址,或是你用來連結 Web IQ 資源的帳號,在 Web IQ 開發者入口網站中。 這通常是你使用 Azure、Teams 或 Office 的地址,可能和你的信箱地址不同。

要確認,請登入 Azure 入口網站,並檢查右上角的電子郵件地址。

為什麼登入顯示我無法存取?

首先,確認 Azure 入口網站右上角顯示的地址是否與擁有 Web IQ 存取權限的地址完全一致。 組織通常會用一個位址來登入 Microsoft,另一個位址用來收電子郵件。

如果電子郵件地址相符,你的組織可能會阻擋跨租戶間對 Microsoft Corporation 租戶的訪客存取。 請你的 IT 管理員允許該存取權限。

我可以在哪裡取得協助?

請造訪 Microsoft Web IQ 支援網站以獲得產品協助。 如有關於允許使用、隱私、儲存或顯示的問題,請參閱現行 的 Web IQ 使用條款 及您適用的客戶協議。

API 認證

支援哪些認證方法?

Web IQ 支援:

  • Microsoft Entra ID 持有人權杖透過 OAuth 2.0 用戶端憑證流程。 建議對生產工作負載使用此項。
  • API 金鑰會在 x-apikey 請求標頭中傳送。

所有 API 流量都使用 HTTPS。

我該如何設定伺服器間的驗證?

在 Microsoft Entra ID 註冊應用程式,並使用 OAuth 2.0 用戶端憑證流程。 將應用程式註冊的 Entra 應用程式(客戶端)ID 綁定到 Web IQ 開發者入口網站中的 Web IQ AppID,取得存取權杖,然後將其作為 Authorization: Bearer <access_token> 傳送。

完整設定步驟請參見 驗證。

我可以自己管理 API 金鑰嗎?

Yes. 你可以從 Web IQ 開發者入口網站建立任意數量的 API 金鑰。 建立金鑰是免費的。

Web IQ 是否使用 Azure RBAC 來進行 API 授權?

No. Web IQ 是 Microsoft 託管的服務,您可透過網際網路呼叫。 你部署在 Azure 訂閱中的 Web IQ 服務資源負責計量和計費,但它不在請求路徑中,因此沒有可供 Azure RBAC 角色指派的服務資源。

Web IQ 依 AppID 對請求進行授權。 每個 AppID 都有自己的內容資格設定檔和配額,未經授權的呼叫會回傳 HTTP 403。 為了區分團隊或工作負載,例如有不同的存取政策或配額,可以使用多個 AppID。

一個 Entra 應用程式(客戶端)ID 可以呼叫多個 Web IQ AppID 嗎?

Yes. 單一 Entra 應用程式(用戶端)ID 可以被授權呼叫一個或多個 AppID。 要選擇 AppID,可以將其作為查詢參數傳入,例如 https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>。 API 對 AppID 的解析方式如下:

  • 你的 Entra 應用程式(客戶端)ID 綁定在一個 AppID:如果你沒有指定 AppID,或是你指定了該 AppID,請求就會成功(HTTP 200)。 如果你指定不同的 AppID,請求會回傳 HTTP 403。
  • 你的 Entra 應用程式(客戶端)ID 綁定了多個 AppID:你必須指定一個。 缺少或空白的 AppID 會回傳 HTTP 400;你綁定的 AppID 之一成功(HTTP 200);任何其他 AppID 則回傳 HTTP 403。
  • 你的 Entra 應用程式(用戶端)ID 並未綁定在任何 AppID:請求會回傳 HTTP 401。

API 金鑰認證(x-apikey)則不受影響。 每個 API 金鑰綁定於單一 AppID,因此 APPID 在金鑰認證呼叫中永遠不需要,也不會被接受。

託管代理應該使用哪種認證:管理身份(Managed Identity)還是代理識別(AgentID)?

兩種方式都可以。 管理身份(Managed Identity)和代理ID都是 Entra ID 身份,而 Web IQ 接受任何其 Entra 應用程式(客戶端)ID 已在 Web IQ 開發者入口網站的設定檔管理頁面中綁定到你的 Web IQ AppID 的 Entra 身份。

你用哪一種取決於代理程式託管於何處:

  • 受控識別適用於在 Azure 基礎結構上執行的代理,例如 Foundry、App Service、Container Apps、AKS、Functions 或 VM。 系統指派和使用者指派身分識別都可行。
  • AgentID 適用於 Foundry 或 Copilot Studio 託管的代理,這些代理會提供代理程式身分識別。
  • 託管在 Azure 外部的代理程式,例如你自己的 Kubernetes 叢集或其他雲端,可以使用標準的 Entra 應用程式註冊,並使用用戶端秘密或聯邦憑證。

在每種情況下,呼叫皆使用 OAuth 2.0 用戶端憑證流程,並將權杖作為 Authorization: Bearer <access_token> 傳送。 關於設定步驟,請參見 驗證。 在 x-apikey 標頭中的 API 金鑰仍是原型中較簡單的選項。

網路和安全性

No. 這些項目目前均不受支援。 Web IQ 透過單一公共端點 https://api.microsoft.ai/v3 以 HTTPS 存取,並使用 Entra ID 或 API 金鑰驗證。 API 端點沒有基於 IP 的存取控制。

你 Azure 訂閱中的 Web IQ 資源負責計量和計費,但不在請求路徑中,因此 Azure 網路控制如 Private Link、VNet 整合、Azure 防火牆、NSG 和樞紐輻射拓撲在 Web IQ 端沒有可連接的資源。 Identity(Entra ID)整合是與 Azure 對齊的;網路層則不是。

在你這邊,請在輸出流量控制中允許 api.microsoft.ai 主機名稱。

從 Azure 到 Web IQ 的流量會留在 Microsoft 的網路中,還是走 Azure 骨幹網路?

這無法保證。 用戶端連接至公共 https://api.microsoft.ai 端點,傳輸過程中的流量則以 HTTPS 保護。

Web IQ API 流量終止於 Azure Front Door,而 Azure Front Door 支援以下密碼套件的 TLS 1.2 與 TLS 1.3:

  • TLS 1.3: TLS_AES_256_GCM_SHA384, TLS_AES_128_GCM_SHA256
  • TLS 1.2: TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Zscaler 或其他出口檢查工具會干擾 Web IQ 嗎?

當設定為允許連接到 api.microsoft.ai 時,不應造成干擾。 這是標準的允許清單操作,並非全面性略過限制。 同樣的方法也適用於其他安全網路閘道,如 Netskope。

我可以把 Web IQ 放在 Azure API 管理 後面嗎?

Yes. 你可以在自己的 Azure 訂閱中,將 Azure API 管理 或其他閘道器放在 Web IQ 前面,以實現可觀察性和治理,且沒有已知的阻擋限制。 API 呼叫會從您的呼叫端透過 TLS 搭配 API 金鑰或 Entra ID 權杖傳送到 https://api.microsoft.ai/v3,所以您放在這些流量前面的東西,都是您租戶裡的基礎架構。 Microsoft 不會為這些部署發布參考架構;你的雲端架構團隊擁有該設計權。

根據 Web IQ 使用條款,回應內容不能被快取或儲存以建立衍生資料集,無論閘道器的功能如何。 運作中的遙測資料如狀態、延遲、標頭及追蹤 ID 可能會被保留,例如在 Application Insights 或 Log Analytics 中。

有哪些安全控制措施可用?

  • 驗證方式:Entra ID(OAuth 2.0 用戶端憑證)或 API 金鑰。
  • 授權:依每個 AppID 對 API 的存取權限。 未經授權的呼叫回傳 HTTP 403。
  • 速率限制:依 AppID 配額限制。 超出限制的請求回傳 HTTP 429。
  • 傳輸:僅限 HTTPS。

您網路周界的網路政策由您負責。 如果您有特定的架構需求想要評估,請聯絡 Web IQ 支援。

速率限制與 API 金鑰

有速率限制嗎?

Yes. 每個 Web IQ AppID 預設每秒查詢次數限制為 15 次(QPS)。 Web IQ 資源通常只有一個 AppID,是連接資源時建立的。 Web IQ 開發者入口網站顯示了這個限制。

這個限制由所有 API 金鑰以及該 AppID 所繫結的 Entra 應用程式(用戶端)ID 共同共用。 超出限制的請求回傳 HTTP 429。

我可以提高我的速率限制嗎?

Yes. 每個 Web IQ AppID 的起始配額為 15 QPS。 若要申請更高限額,請提交 Web IQ 支援請求,說明你預期的流量與使用情境。

我可以建立多少個 API 金鑰?

你可以根據應用程式的需求建立任意數量的金鑰。 金鑰建立是免費的,但同一 AppID 的所有金鑰都會共享速率限制。

隱私權和資料處理

Web IQ 會記錄 API 查詢嗎?

Yes. API 請求會被記錄為營運目的:服務可靠性、除錯及品質提升。 這是 Microsoft 服務的標準做法。

  • 存取權限僅限授權的 Microsoft 工程與營運人員,並受 Microsoft 內部存取控制政策所規範。 日誌中的資料無法被其他客戶或第三方存取。
  • 日誌儲存在 Microsoft 的生產基礎設施中,並受到 Microsoft 標準的安全控管,包括基於角色的存取控制與稽核追蹤。
  • 日誌在傳輸中(HTTPS)及靜態儲存時均採用 Microsoft 標準加密技術進行加密。

Microsoft 根據 Microsoft 隱私權聲明,作為資料控制者運作。

查詢會保留多久?

查詢遙測的保留受 Web IQ 使用條款第 4 節規範,該條款要求 Microsoft 的處理遵守 Microsoft 隱私聲明。 除了隱私聲明所述之外,沒有針對 Web IQ 的獨立資料保留承諾。

我可以關閉受規範或敏感工作負載的查詢日誌嗎?

查詢文字會被擷取為標準請求遙測資料的一部分,其處理方式受 Microsoft 隱私聲明及 Web IQ 使用條款第 4 節規範。

如果你有特定的法規或合規驅動因素,Web IQ 提供 Zero Query Logging,能抑制遙測資料中的查詢文字。 查詢仍會送達 Microsoft 以執行該請求;零查詢記錄將查詢文字排除在我們的日誌之外。 它不是自助服務:我們的產品團隊會為你開啟它,無論是針對所有應用,還是只針對特定應用。 要申請,請聯絡你的 Microsoft 帳戶 團隊並分享:

  • 適用的法規或合規架構(例如GLBA、HIPAA、GDPR或APPI)。
  • 簡要說明你的部署情境。

在零查詢日誌中,查詢文字、結果標題與網址、IP 位址及 Entra 應用程式 ID 都不會被保留。 AppID、追蹤ID、時間、狀態和帳單欄位都會被保留,這樣我們才能執行此服務並收取費用。 你這邊不需要設定任何東西。

我可以檢查 Zero Query Logging 是否已啟用嗎?

現在在 Web IQ 開發者入口網站或 API 裡都沒有。 如果你需要確認,例如為了稽核,請使用你的 AppID 提交 Web IQ Support 支援請求,Web IQ 支援會以書面形式確認該設定。

Web IQ 提供哪些資料駐留承諾?

今天沒有任何項目。 Web IQ 不會針對特定區域的資料駐留或區域內處理作出承諾,且跨區域路由至最近可用端點是預期行為。 隱私權受 Microsoft 隱私聲明規範。 Microsoft 並未承諾可存取資料之人員所在位置或國籍。

Web IQ 是否受 Azure 資料保護附錄或歐盟資料邊界涵蓋?

No. Web IQ 使用條款第 4.1 節將該服務排除在 Microsoft 產品與服務資料保護附錄之外。

相反地,Microsoft 與客戶就根據使用條款(第 4.4 節)處理的任何個人資料,各自作為獨立的資料控制者行事。 Microsoft 的處理程序受 Microsoft 隱私聲明(第 4.2 節)規範,您有責任向您的終端使用者提供適當通知。

對於國際傳輸,使用條款在必要時納入標準合約條款(第4.6.1節)。 該轉移機制透過使用條款進行,該條款屬於您的 Microsoft 客戶合約,而非資料保護附錄。

Web IQ 目前不做出歐盟資料邊界、特定區域資料駐留或區域內處理承諾。

Web IQ 是否能偵測或隱藏查詢中的個人資料?

No. Web IQ 不會在伺服器端偵測或掩蔽傳入查詢中的個人資料。 如果工作負載可能傳送個人或敏感資料,請先在呼叫 Web IQ 之前清除這些資料,例如使用 Azure AI 語言 PII 偵測作為預處理步驟。 這樣就不會有敏感的資訊流失,你也能完全掌控哪些內容會傳到 API。

Web IQ 是否支持受監管產業?

Yes. Web IQ 支援多種企業及受規範的使用情境。 如果您有特定的法規遵循、治理或產業要求,請聯絡 Web IQ 支援。

內容安全與涵蓋範圍

套用了哪些內容安全控制項?

Web IQ 採用在爬取時進行的品質與安全分類、成人內容過濾,以及每個客戶的內容資格規則。 SafeSearch 預設是伺服器端 strict 強制執行的。 網路搜尋結果也包含一個 isAdult 欄位,供額外的用戶端處理。

Web IQ 是否能保護 LLM 不受檢索內容中的提示注入影響?

Microsoft Web IQ 從網路上檢索並排序內容;它不會執行、解釋或依據嵌入於檢索內容中的指令採取行動。 Web IQ 以 Bing 現有的品質、信任、垃圾訊息及惡意內容篩檢功能,補充了這種檢索行為。

防範間接提示注入、越獄嘗試及指令跟隨攻擊的主要責任在於下游模型與編排層。 將提示與擷取內容視為不可信輸入,並套用多層控制措施,如 Prompt Shields、Azure AI 內容安全、系統提示隔離、最低權限工具存取、依據驗證及輸出驗證。 Web IQ 不應被視為提示注入緩解的唯一執行點。

Web IQ 在回傳內容之前,網站內容是如何處理的? 它有經過清理以避免類似提示式的指示嗎?

Microsoft Web IQ 在檢索時不會直接操作原始頁面 HTML。 在索引過程中,網頁內容會被正規化為結構化的文件表示,旨在保留有意義的內容與文件結構。 Web IQ 回傳的段落是從該表示形式中選出,這使得在整個 API 範圍內能更一致地擷取與檢索。 Bing 現有的品質、安全、垃圾郵件及惡意內容篩檢功能也納入索引流程。

Web IQ 無法保證回傳的內容不含腳本或惡意軟體,而這種標準化也不保證能辨識或移除類似提示的文字。 將檢索的內容視為不可信輸入,並套用在前一則回答中所述的模型層與協調層保護。

Web IQ 會回傳隱藏或非使用者可見的頁面內容嗎?

Microsoft Web IQ 嘗試回傳透過正常使用者互動可見的內容,包括透過普通頁面控制或用戶端渲染顯示的內容。 這無法保證。 頁面結構與實作各異,因此應用程式不應假設每段回傳的段落在頁面初始狀態下皆可見,或每個隱藏元素都會被排除。

Microsoft 如何維持索引品質?

頁面會就品質、權威性及可信度進行評估。 惡意、垃圾郵件及釣魚內容會被偵測並排除,索引也會持續更新。 這也是 Microsoft 自家 AI 產品所依賴的同一個指數。

Web IQ 如何尊重出版商的內容偏好?

Web IQ 旨在尊重受支援的發布者控制機制,包括適用的 robots.txt 指令及其他由 Microsoft 認可的發布者訊號。

有沒有公開的排除網站或封鎖類別清單?

No. 排除控制包括 robots.txt 合規、法律及合規移除(如 DMCA 通知與法院命令)、垃圾郵件、惡意軟體與釣魚過濾,以及成人內容過濾。 這些清單本身是專有的,並且持續更新。 如果你對特定類別的內容在搜尋結果中出現或不出現有疑慮,請聯絡 Web IQ 支援 ,討論你的 Web IQ AppID 設定是否符合這些要求。

Web IQ 涵蓋哪些內容?它有多新鮮?

Web IQ 持續擷取網頁、新聞、影像與影片結果中的新鮮資訊,協助您的 AI 代理或應用程式回答模型訓練資料之外的問題。

可用性與新鮮度會依 API、來源類型及使用情境而異;所有內容都沒有單一的新鮮度保證。 在選擇來源和檢索設定時,請考慮你工作負載的新近性需求。

Web IQ 支援哪些語言和市場?

Web IQ 從全球網路汲取資源,但涵蓋範圍會依語言、市場、主題及來源類型而異。 請參考 支援語言與地區 頁面,了解每個 API 接受的代碼,並根據目標用戶所需的資訊評估覆蓋範圍。

中國的客戶應致電 https://api.microsoftol.com/v3;新聞搜尋在該處無法使用(基地網址)。

我可以設定網域允許或拒絕清單嗎?

對於個別網域或小型清單,可以使用標準查詢運算子,例如 site:example.com 包含網域或 -site:example.com 排除網域。 若要在網路搜尋或新聞搜尋中重用一組命名的包含與排除規則,請為帳單帳戶建立一個具有範圍管理功能的 Web IQ 範圍 。 命名範圍支援每個列表最多 10,000 個標準化獨立選擇器,但須遵守 合併定義大小限制。

為什麼我看不到 LinkedIn 的結果?

目前不包含 LinkedIn 結果。

當針對已排除的 URL 呼叫 Browse 時會發生什麼事?

Browse 回傳 HTTP 403。 底層排除名單不會公開。

我該如何讓我的網站能被 Web IQ 發現?

Web IQ 是建立在 Microsoft 自家 AI 產品所使用的同一個網頁索引上。 請使用標準的網頁發現方式,如 sitemaps、IndexNow、Bing 網站管理員工具 以及適當的 robots.txt 政策。 沒有獨立的 Web IQ 提交路徑。

命名搜尋範圍

我該如何控制和篩選 Web IQ 的結果?

使用 Scopes 來篩選網頁搜尋和新聞搜尋結果,並附上可重複使用的網址、網站、網域或路徑清單,方便包含或排除。 建立一個命名的範疇,然後用 scopeName 請求參數選取它。 排除項目優先於包含項目。 請參閱 用Scopes篩選結果。

Web IQ 帳單帳號與 AppID 或 Entra 客戶端 ID 有何不同?

Web IQ 帳單帳號會將 Web IQ AppID、帳號存取權及指派範圍集合分組。 Web IQ AppID 會選擇您的應用程式的執行時搜尋設定。 Entra 應用程式(用戶端)ID 用來識別取得 Entra 權杖的應用程式註冊;它不是任一個 Web IQ ID。 請參閱 關鍵概念 與 授權資源發現。

我可以用我的搜尋憑證來建立範疇嗎?

搜尋權限不會自動授予管理權限。 呼叫客戶管理 API 的應用程式需要一個僅限應用程式的 Entra 權杖,以及目標帳單帳戶上的 CustomerApiAccess。 人工帳號管理員會另外授權。 請參閱 授與應用程式管理 API 的存取權。

範圍是特定於某一個 Web IQ AppID 的嗎?

No. 帳單帳戶中的 Web IQ AppID 使用其分配的範圍集合。 名稱在該集合內必須以不區分大小寫的方式保持唯一。 指派給同一集合的帳號會共享其定義,因此編輯或刪除會影響所有使用這些定義的對象。 知道一個名字並不代表能存取另一個帳號的權限範圍。

空的包含清單會讓範圍失效嗎?

No. 包含清單為空時,允許所有未排除的來源。 如果兩個清單都是空的,範圍本身沒有網站限制。 排除一律優先於納入。

如果搜尋找不到我的範圍怎麼辦?

failOnMissingScope 預設為 true:回報的範圍套用失敗會回傳錯誤,而非未套用範圍的結果。 名稱錯誤或傳播不完整可能導致範圍遺失。 如果你明確設定 false,搜尋可以針對整個索引進行,但會缺少範圍並回報 scopeApplied: false。 只有在不受範圍限制的結果可接受時才使用該設定。 請參閱 命名範圍錯誤。

scopeApplied 為 true 是否表示搜尋使用了我最新的範圍定義?

No. scopeApplied: true 表示該請求已套用某個範圍。 它不標示所使用的版本,也不保證全域傳播。 當未報告申請結果時,該欄位為可選;不要假設它總是存在,或在沒有 scopeName 的請求中為 false。

若在推出時無法接受使用先前定義,請在 切換呼叫端之前,以新名稱建立並驗證 scope。 目前還沒有就緒端點或範圍版本控制。 全局傳播通常約需10分鐘,但在某些情況下可能長達30分鐘。 目前沒有傳播 SLA,這些時間也無法保證。 切換來電者並非全域原子操作。

查詢行為與結果品質

我應該用自然語言查詢還是關鍵字查詢?

兩者都能使用。 自然語言查詢通常適合使用 contentFormat=passage,而關鍵字查詢則適合精確查詢,例如公司名稱、股票代號或特定主題。 避免過長或複合的查詢;將多個資訊需求拆分成獨立的 API 呼叫。

最大查詢長度是多少?

上限為 1,000 字元,較長的查詢會被拒絕。 較短且聚焦的查詢通常能產生較佳的結果:如果查詢包含大量上下文,檢索可能無法聚焦於正確的訊號。

我可以依日期篩選網頁搜尋結果嗎?

網路搜尋目前沒有提供日期範圍篩選,我們建議除非你真的需要,否則避免使用硬性日期篩選。 根據查詢排序時,新鮮度已經被納入考量,加上硬性日期限制幾乎總是會降低相關性。 對於新聞情境,請使用新聞 API,而非依日期篩選網頁搜尋結果。

lastUpdatedAt 是出版商最後更新內容的日期,而不是 Web IQ 最後檢查該頁面的日期,所以較舊的日期不代表頁面最近沒被檢查過。 它在回應中被回傳,不是請求篩選器,也不是每個結果都有。 你可以用它在你的應用程式中對結果進行排序或篩選。

網路搜尋能處理包含多個問題的提示嗎?

每個網路搜尋請求處理一個查詢。 如果一個提示包含多個問題或意圖,請在應用程式中將其拆分成獨立查詢,分別呼叫網路搜尋,並在產生答案前將結果合併。

Web IQ 能支援多步驟代理工作流程嗎?

Yes. 代理人在任務中需要額外網路證據時,可以呼叫 Web IQ。 檢索延遲在需要多次呼叫後才產生答案的工作流程中尤其重要。

我的 AI 代理或應用程式應該如何處理被檢索的證據?

使用與問題相關的證據,並追蹤哪些來源支持該答案。 將檢索的內容與控制代理的指令分開。 當資料來源有衝突或證據不完整時,應明確表達不確定性,而非用毫無根據的陳述填補空白。

根據性品質如何比較?

Microsoft 在其公開比較中,紮根滿意度最高,得分為 79.05。 結果取決於查詢集、模型和評估方法,因此請在自己的情境中驗證品質。

資料來源: Web IQ 基準測試結果。 3K 全球,從生產環境取樣的 Blind Queries,設定:10 個結果,每個結果 10K 字元(或等效值)。

Web IQ 對健康資源的處理方式不同嗎?

Web IQ 的排名模型使用來源可信度訊號。 對於健康相關查詢,這些訊號是以美國國家醫學院獨立制定的原則為依據。 這適用於網頁搜尋,以及來自網頁搜尋的 自動 結果;這不適用於新聞。 這是自動的:沒有什麼可以開啟的。 我們不會公布名單或來源數量。 若要限制結果僅限於你選擇的網站,請使用 Scopes。

為什麼結果會和 Bing.com 不同?

Web IQ 針對 LLM 的使用、事實密度、文章品質及低延遲進行優化。 Bing.com 是一種面向消費者的體驗,包含額外的排名訊號、個人化、視覺化答案,以及可能無法透過 API 再分發的內容。 排名上有些差異是預期的。

相同的請求會不會回傳不同的結果?

由於索引會持續更新,且更新會跨資料中心傳播,因此預期會有一定的變化。 相同請求在近期發生時,結果應大致保持穩定。 如果您在相同查詢中發現數秒內有顯著差異,請聯絡 Web IQ 支援。

為什麼查詢回傳的結果比預期少?

在計數結果前,先檢查原始的 Web IQ 回應。 最常見的原因是客戶端設定或下游流程步驟,會在結果被測量前過濾掉有效結果。 同時也要確認 maxResults、內容資格、SafeSearch 行為,以及查詢中的任何 site: 或 -site: 操作員。

語言、地區和地點如何影響結果?

查詢的語言本身最為重要; language 和 region 參數扮演次要角色,其效果會因 API 而異。 任何支援的語言都能與任何支援的區域搭配使用,例如 en 搭配 IN、AU 或 NZ。 區域會影響排名、來源組合及單位(例如 °C 或 °F),但不會影響日期格式。 關於全域主題的查詢仍然會回傳全域結果。 對於像「附近天氣」這類在地查詢,地點比地區更重要。

這兩個參數都使用兩個字母的代碼;其他值則回傳 HTTP 400。 若不支援兩字母區域,Web IQ 則使用 US。 如果不支援兩字母語言,則會使用該區域的預設語言。 兩種情況都未回傳錯誤。 這在網頁搜尋、新聞搜尋和 Auto 中也是一樣的。請參見 支援語言與地區。

自動和自動進階有什麼差別?

它們是同一個 API 的兩種模式。 自動(Auto)預設會為問題選擇來源,並在一次呼叫中回傳引用的證據。 Auto Advanced 會為複雜題目執行額外的檢索輪次;使用時,設定 "mode": "advanced"。 採另行計費;詳見 定價。

我需要搭配 Auto 使用 responseFilter 嗎?

No. 自動決定查詢需要哪些證據(網頁、新聞、天氣等),並在一次呼叫中回傳,因此不必分別呼叫每個 API。 responseFilter 列出 Auto 可包含的證據類型;省略後,所有類型都符合資格。 若要省略你永遠不想要的類型,例如圖片或影片,請只列出你想要的(例如, ["web", "news"])。 為你的應用程式設定一次,而不是針對每次查詢分別設定。 自動支援與網頁搜尋相同的語言和地區,且 responseFilter 在每個地區的運作方式都與網頁搜尋相同。 請參閱 Auto API 參考資料。

內容格式

每個結果會返回什麼:段落還是完整文件?

網頁搜尋與新聞搜尋會在 content 欄位中傳回每個結果的內容。 設定 contentFormat 為 passage時,你會得到與查詢最相關的文件部分。 使用 text、html 或 markdown,即可獲得完整文件內容:Web IQ 在建立索引期間建構的頁面結構化版本。 段落適用於各種應用程式;完整文件格式需要完整文件存取權限。 圖片和影片會回傳結果細節,如標題、網址和縮圖,而非頁面內容。 地點回傳結構化的地點資訊,如地址、營業時間、評論、照片,以及與查詢相關的段落。 請參閱 段落與內容格式。

什麼是 passage,為什麼要用它?

設定 contentFormat=passage ,API 對每個結果只會回傳與查詢最相關的文件段落,而非完整文件。 完整文件由 Web IQ 端處理,回傳的是一個針對查詢的擷取,讓你的大型語言模型不必跳過無關段落來找到相關句子。

  • 代幣節省:LLM 會接收文件的一部分,而非全部。
  • 更佳的事實性:語境中離題內容減少,模型較不容易停留在離題段落。

對每一個 Web Search 和 News 請求都設定 contentFormat=passage。 Browse 也支援 passage:發送一個 query,且 Browse 會回傳與查詢最相關的頁面部分。

我應該用哪種格式?

用 passage 來接地。 這是推薦格式,適用於所有應用程式。 需要整份文件時,請使用 text、markdown 或 html,例如用於摘要或從整頁中擷取內容。 這些格式的檔案需要完整的文件存取權限。

我應該在每個請求中設定 contentFormat 和 maxLength 嗎?

Yes. 在每個網路搜尋和新聞請求中同時設定兩者,確保你總是得到預期的格式和長度。

content 欄位可以有多長?

最多 maxLength 個字元。 若無法完全存取文件,每個結果最多也只有 3,000 字元,即使 maxLength 的值更高。 在完整文件存取下,content 可達 maxLength,最多為 500,000 個字元。 長於 maxLength 的完整文件會被截斷。

為什麼當我將 text 設為 html、markdown 或 AuthContentFormatForbidden 時,會出現 HTTP 403(contentFormat)?

在網頁搜尋與新聞搜尋中,text、html 和 markdown 會傳回完整文件,且需要完整文件存取。 若無此,這些格式會回傳帶有錯誤代碼 AuthContentFormatForbidden的 HTTP 403 。 passage 適用於所有應用。

如何取得完整文件,格式為 text、html或 markdown?

開啟 Web IQ 支援請求。 已使用 html 或 text 的應用程式,仍會如同目前一樣繼續運作。

Browse 會回傳什麼?

瀏覽內容會傳回你選擇的網址內容,最多可達 maxLength 字元。 將 contentFormat 設為 passage 和 query,則會回傳與查詢最相關的頁面部分。 除非你的應用程式擁有完整文件存取權,否則這是預設格式。 在完整文件存取權下,也能以 text、html 或 markdown 的形式傳回整份文件。 請參閱 瀏覽API參考資料。

為什麼我在沒有發送 query 時,會從 Browse 收到 HTTP 400?

傳遞要求需要一個非空白的 query 值。 passage 除非你的應用程式擁有完整文件存取權,否則是預設格式,因此在每個瀏覽請求中請包含 query 最多 1000 個字元。 請參閱 段落與內容格式。

我應該如何調整 maxResults 和 maxLength,以管理上下文視窗和代幣成本?

Web IQ 可以優先處理與查詢相關的段落,而不是提供不必要的頁面上下文。 這可以減少傳給模型的文字量,並降低輸入標記成本。 優點取決於你的模型、提示詞、查詢組合和檢索設定。

對於大多數 grounding 情境,在總代幣預算大致相同的情況下,較多的結果搭配較短的段落,通常比少量結果搭配較長的段落產生更好的輸出。 一個不錯的起點是 maxResults=10,maxLength 約 3,000 個字元,採用 passage 格式。 用你自己的查詢和模型來做基準測試。

為什麼網頁搜尋和新聞搜尋不會傳回 snippet 欄位?

這是原廠設定。 兩者皆回傳依賴查詢的擷取content(snippet),而非獨立且與查詢無關的passage。

回應內容

網路搜尋每次請求最多支援 50 個結果。

我可以設定哪些請求參數?

網路搜尋會顯示maxResults、language和region、safeSearch(markdown、text、maxLength或contentFormat)、passage和html。 完整參數列表請參閱 API 參考資料。

lastUpdatedAt和crawledAt有什麼區別?

lastUpdatedAt 是發布者報告的內容更新日期,在可用時透過網路搜尋、新聞、影片、圖片、瀏覽及自動回傳。 crawledAt 是 Web IQ 最後一次擷取該頁面的時間,此資訊由網頁搜尋、瀏覽、新聞和 Auto 傳回。這不是您提出請求的時間。 這兩個欄位的涵蓋範圍會因結果而異,並非每個結果都包含這兩個欄位。

什麼是 Browse Live Crawl?我應該什麼時候使用它?

瀏覽會回傳 Bing 網頁索引的內容,隨著爬蟲觀察網路變化,索引會持續更新。 這就是網路搜尋的運作方式:搜尋結果是從索引中提供,而不是在每個請求中即時取得每個 URL,這也是 Browse 速度與一致性的關鍵。

Browse 支援對索引中未提供的網址進行 即時爬取。 在請求上設定 liveCrawl: "fallback",以便在索引副本遺失時要求即時擷取。 即時爬蟲會受到發布者抓取禮儀限制及可用性的限制;fallback 但不保證實際會執行爬取。 如果有索引內容,瀏覽會回傳該內容。 省略參數(或設定 liveCrawl: "none")只會回傳索引內容,不進行即時爬取。 完整參數詳情請參閱Browse API 參考文件。

Live Crawl 預設在 Web IQ Browse 上可用,且每秒容量上限有限,與整體 Browse QPS 分開。 這個上限在 AppID 下的所有 API 金鑰中是共享的。 大多數瀏覽工作負載不需要即時爬取,最佳方式是標準索引路徑;當索引中沒有網址時,請使用 Live Crawl。

Browse 可以檢索 JavaScript 渲染的頁面嗎?

Yes. 與 renderDynamicPages: true 一起使用 liveCrawl: "fallback"。 完整參數集與回應細節請參閱 Browse API 參考文件。 在你依賴這種行為之前,先測試代表性的網址。

Browse 可以提取線上 PDF 檔案嗎?

線上託管的 PDF 目前並不是一個有文件記載的瀏覽情境。 如果你有特定的 PDF 使用案例,請聯絡 Web IQ 支援 ,並提供代表性的網址和你期望的行為,你會得到明確的答案。

Web IQ 的費用是多少?

Web IQ 採用以用量為基礎、按次呼叫收費的方案。 價格取決於你帳戶啟用的 API、使用情況以及商業條款。 請參閱 Pricing 以查看目前費率。 Web IQ 是透過 Azure 計費,因此你的使用量會計入 Microsoft Azure 消費承諾(MACC),而 Azure 消費折扣(ACD)及其他協商的 Azure 折扣也會適用於這些費率。 商業在私人預覽中也是按呼叫計費:搜尋、優惠和產品詳情共用一個計量且費率相同。

帳單會在 Azure 中如何顯示?

Web IQ 的使用量會被計量,並透過你的 Web IQ 資源向你的 Azure 訂閱計費。 服務本身是 Microsoft 託管的,不是佈建於您的租用戶中。

要查看你的 Web IQ 成本,請在 Azure 入口網站中開啟您訂閱的 成本分析,使用 依資源區分成本 檢視,並選擇資源類型microsoft.webiq/accounts進行篩選。 你呼叫的每個 API(例如網頁搜尋、圖片或新聞)都會顯示成獨立的計量表。 Auto 有兩個計量表,一個用於 /auto,另一個用於含有 mode: advanced 的 /auto。 Commerce API 共用一個電表。

Web IQ 是否包含 SLA、RTO 或 RPO 承諾?

No. Microsoft Web IQ 不包含服務水準協議。 Web IQ 使用條款不承諾運作時間、延遲、恢復時間目標(RTO)或恢復點目標(RPO),且不會為個別客戶新增服務等級協議條款。

我需要顯示引用嗎?

Yes. Web IQ 使用條款第 1 節(LLM 使用)要求標註來源,並附上指向每個用於顯示 LLM 內容的來源(靠近該內容)的連結。

  • 只引用實際用來產生答案的來源。 如果 Web IQ 回傳 10 個結果,而你的模型用了 3 個,就顯示這 3 個。
  • 引用必須與答案一同可見,且只需一次操作即可存取。 不要只短暫顯示它們,也不要把它們藏在多個螢幕後面,或要求使用者分別索取來源。
  • 對於受限介面,如汽車、穿戴裝置、語音優先裝置或自助服務機,使用持久性的 QR 碼,該碼會導向到列出目前答案所用所有引用的頁面,或是顯示答案及可點擊引用的配套應用程式,或使用者可直接開啟的螢幕列表。

你可以將與 LLM 摘要一同顯示的來源連結,存放在終端用戶的聊天紀錄中,或作為內部工作成果的一部分。 請參考下方的快取問題。

我的 AI 代理或應用程式能顯示多少來源內容?

Web IQ 使用條款附件 A 限制了從單一來源顯示的 Grounding 內容,不得超過 200 字元或網站擁有者或網站管理員指定上限中較小者。 對於語音或音訊體驗,也請將相同限制套用於語音輸出。 摘要與展示有額外限制。 在設計摘錄前,請先閱讀使用條款;此限制並非允許重現整個原始頁面。

影像和影片的結果可以用來作為 LLM 的依據嗎?

影像與影片元資料及替代文字包含在「Grounding 內容」的定義中。 然而,Web IQ 使用條款禁止使用結果中的實際影像或影片用於 grounding、將其包含在大型語言模型輸出中,或以其製作衍生影像或影片。 請審閱您預期實施的相關規定。

我可以快取或儲存 Web IQ 內容嗎?

一般來說,不是。 Web IQ 使用條款禁止複製、儲存、快取、存檔或建立內容資料庫,除非條款允許(第 3.2.15 節及附件 A 第4節):

  • 終端用戶聊天歷史:你可以以非彙總、每位終端用戶的聊天紀錄方式,根據適用法律允許,將 LLM 摘要(即您的應用程式根據終端用戶的基礎內容,第 2.5 節所產生的摘要)儲存。
  • 內部工作產品:你可以將LLM摘要及其附帶的來源連結作為內部工作成果的整合部分,如備忘錄、報告、簡報或安全與稽核日誌,依版權法允許的範圍而定。 它們不能作為服務或內容的替代品,例如建立內容資料庫、索引連結、網路爬取或擷取,或提供獨立搜尋。
  • 原子行動暫時處理:內容僅在完成由大型語言模型(LLM)發起的單一邏輯請求或工作流程(稱為「原子行動」,可能涉及多個內部步驟或代理互動)時,才會被暫時處理。 原子行動完成後,內容必須立即刪除。

除上述例外外,請勿儲存搜尋結果本身:使用條款不允許衍生資料庫、持續快取或內容長期存檔。

我在哪裡可以閱讀 Web IQ 使用條款?

目前的條款已於 Microsoft Web IQ 使用條款中公布。 它們會與你現有的 Microsoft 客戶合約 一起適用。