關於使用 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取得。 目前可用的 API 包括網頁搜尋、新聞、影片、圖片和瀏覽。
自動 提供測試版。
什麼是 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 和 Videos 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 資源。 該資源處理識別、計量及計費。
該服務本身由 Microsoft 託管,且為多租用戶架構。 Web 擷取與排名在 Microsoft 基礎結構中執行,而您的應用程式則透過 HTTPS 呼叫 api.microsoft.ai。 Azure 資源不承載 Web IQ,也不在請求路徑中。
Web IQ 部署在哪裡?
Web IQ 由 Microsoft 託管,並透過公開https://api.microsoft.ai/v3端點提供。 你的應用程式呼叫 API,而 Web IQ 則在伺服器端執行網頁檢索。
有沒有專門針對金融、體育或天氣的 API?
今天不行。 專用的 API 包括網頁搜尋、新聞、影片、圖片和 Browse API。 對於財經、體育、天氣及其他沒有專用 API 的主題,請使用 Web Search,該功能會回傳相關的爬取內容。 這些內容是無結構的頁面文字,而非結構化的資料饋送。
存取與導入
我該如何從評估轉到正式環境?
- 完成評估並確認服務符合您的需求。
- 您的 Azure 訂閱已啟用以支援 Web IQ。
- 在該訂閱中部署 Web IQ 資源,然後登入 Web IQ 客戶網站並連接該資源。 這會建立你的生產版 AppID,從預設的每秒 15 查詢(QPS)開始。
- 要使用 Entra ID 驗證,請在 Web IQ 客戶網站將你的應用程式的客戶端 ID 加入該 AppID。
您使用 Web IQ 的行為受 Web IQ 使用條款規範,並依據您現有的 Microsoft 客戶合約 進行。
我可以使用哪些 Azure 訂閱?
Web IQ 需要付費的 Azure 訂閱。 Azure 信用點數無法用於 Web IQ。
我應該用哪個電子郵件地址登入?
請使用有權限存取 Web IQ 的 Microsoft 登入地址:即 Microsoft 為你啟用的地址,或是你在 Web IQ Customer Site 中用來連結 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 用戶端憑證流程。 將應用程式的用戶端 ID 加入你的 Web IQ AppID 中,在 Web IQ 客戶網站取得存取權杖,然後將其作為 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 可以呼叫多個 AppID 嗎?
Yes. 單一 Entra 應用程式(用戶端)ID 可以被授權呼叫一個或多個 AppID。 要選擇 AppID,可以將其作為查詢參數傳入,例如 https://api.microsoft.ai/v3/search/web?appid=<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)?
兩種方式都可以。 受控識別與 AgentID 皆為 Entra ID 身分,而 Web IQ 會接受任何 Entra 身分,只要其應用程式(用戶端)ID 已在 Web IQ 客戶網站的「設定檔管理」頁面中連結至您的 Web IQ 應用程式設定檔。
你用哪一種取決於代理程式託管於何處:
- 受控識別適用於在 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 金鑰仍是原型中較簡單的選項。
網路和安全性
Web IQ 支援 Private Link、私有端點、VNet 整合或 IP 允許清單嗎?
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 資源預設每秒查詢次數上限為 15 次(QPS)。 這個限制適用於你連接資源時建立的 AppID,而 Web IQ 客戶網站會顯示該 AppID。
這個限制由該 AppID 的所有 API 金鑰和 Entra ID 用戶端共用。 超出限制的請求回傳 HTTP 429。
我可以提高我的速率限制嗎?
Yes. 每個 Web IQ 資源起始為 15 QPS。 若要申請更高額度,請聯絡 Web IQ 客服 ,告知您的預期流量與使用情境。
我可以建立多少個 API 金鑰?
你可以根據應用程式的需求建立任意數量的金鑰。 金鑰建立是免費的,但同一資源的所有金鑰都會共享其速率限制。
隱私權和資料處理
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 帳戶 團隊並分享:
- 適用的法規或合規架構(例如GLBA、HIPAA、GDPR或APPI)。
- 簡要說明你的部署情境。
Web IQ 提供哪些資料駐留承諾?
今天沒有任何項目。 Web IQ 不會針對特定區域的資料駐留或區域內處理作出承諾,且跨區域路由至最近可用端點是預期行為。 隱私權受 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 會回傳隱藏或非使用者可見的頁面內容嗎?
Microsoft Web IQ 嘗試回傳透過正常使用者互動可見的內容,包括透過普通頁面控制或用戶端渲染顯示的內容。 這無法保證。 頁面結構與實作各異,因此應用程式不應假設每段回傳的段落在頁面初始狀態下皆可見,或每個隱藏元素都會被排除。
Microsoft 如何維持索引品質?
頁面會就品質、權威性及可信度進行評估。 惡意、垃圾郵件及釣魚內容會被偵測並排除,索引也會持續更新。 這也是 Microsoft 自家 AI 產品所依賴的同一個指數。
Web IQ 如何尊重出版商的內容偏好?
Web IQ 旨在尊重受支援的發布者控制機制,包括適用的 robots.txt 指令及其他由 Microsoft 認可的發布者訊號。
有沒有公開的排除網站或封鎖類別清單?
No. 排除控制包括 robots.txt 合規、法律及合規移除(如 DMCA 通知與法院命令)、垃圾郵件、惡意軟體與釣魚過濾,以及成人內容過濾。 這些清單本身是專有的,並且持續更新。 如果您對某些類別的內容在結果中出現或不出現有疑慮,請聯絡 Web IQ 支援 ,討論您的應用程式設定檔是否能滿足這些需求。
Web IQ 涵蓋哪些內容?它有多新鮮?
Web IQ 持續擷取網頁、新聞、影像與影片結果中的新鮮資訊,協助您的 AI 代理或應用程式回答模型訓練資料之外的問題。
可用性與新鮮度會依 API、來源類型及使用情境而異;所有內容都沒有單一的新鮮度保證。 在選擇來源和檢索設定時,請考慮你工作負載的新近性需求。
Web IQ 支援哪些語言和市場?
Web IQ 從全球網路汲取資源,但涵蓋範圍會依語言、市場、主題及來源類型而異。 請參考 支援語言與地區 頁面,了解每個 API 接受的代碼,並根據目標用戶所需的資訊評估覆蓋範圍。
我可以設定網域允許或拒絕清單嗎?
對於個別網域或小型清單,可以使用標準查詢運算子,例如 site:example.com 包含網域或 -site:example.com 排除網域。 較大的可配置清單目前尚未開放為客戶可管理的功能。
為什麼我看不到 LinkedIn 的結果?
目前不包含 LinkedIn 結果。
當針對已排除的 URL 呼叫 Browse 時會發生什麼事?
Browse 回傳 HTTP 403。 底層排除名單不會公開。
我該如何讓我的網站能被 Web IQ 發現?
Web IQ 是建立在 Microsoft 自家 AI 產品所使用的同一個網頁索引上。 請使用標準的網頁發現方式,如 sitemaps、IndexNow、Bing 網站管理員工具 以及適當的 robots.txt 政策。 沒有獨立的 Web IQ 提交路徑。
查詢行為與結果品質
我應該用自然語言查詢還是關鍵字查詢?
兩者都能使用。 自然語言查詢通常適合使用 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 字元(或等效值)。
為什麼結果會和 Bing.com 不同?
Web IQ 針對 LLM 的使用、事實密度、文章品質及低延遲進行優化。 Bing.com 是一種面向消費者的體驗,包含額外的排名訊號、個人化、視覺化答案,以及可能無法透過 API 再分發的內容。 排名上有些差異是預期的。
相同的請求會不會回傳不同的結果?
由於索引會持續更新,且更新會跨資料中心傳播,因此預期會有一定的變化。 相同請求在近期發生時,結果應大致保持穩定。 如果您在相同查詢中發現數秒內有顯著差異,請聯絡 Web IQ 支援。
為什麼查詢回傳的結果比預期少?
在計數結果前,先檢查原始的 Web IQ 回應。 最常見的原因是客戶端設定或下游流程步驟,會在結果被測量前過濾掉有效結果。 同時也要確認 maxResults、內容資格、SafeSearch 行為,以及查詢中的任何 site: 或 -site: 操作員。
回應內容
為什麼網頁搜尋和新聞搜尋不會傳回 snippet 欄位?
這是原廠設定。 兩者皆回傳依賴查詢的擷取content(snippet),而非獨立且與查詢無關的passage。
網路搜尋支援哪些內容格式?
使用 passage 時,每個結果會回傳與查詢最相關的文件部分,最多可達 maxLength 字元(若無法完整存取文件,最多為 3,000 個字元)。 這是建議的接地方式。 具備完整文件存取權的應用程式也可以使用 text、html 和 markdown。 請參閱 段落與內容格式。
什麼是 passage,為什麼要用它?
設定 contentFormat=passage ,API 對每個結果只會回傳與查詢最相關的文件段落,而非完整文件。 完整文件由 Web IQ 端處理,回傳的是一個針對查詢的擷取,讓你的大型語言模型不必跳過無關段落來找到相關句子。
- 代幣節省:LLM 會接收文件的一部分,而非全部。
- 更佳的事實性:語境中離題內容減少,模型較不容易受離題段落牽引。
對每一個 Web Search 和 News 請求都設定 contentFormat=passage。 Browse 不支援 passage,因為它會擷取你已經選定的特定 URL,且沒有可據以擷取的查詢。
網路搜尋的最大值是多少 maxResults ?
網路搜尋每次請求最多支援 50 個結果。
我可以設定哪些請求參數?
網路搜尋會顯示maxResults、language和region、safeSearch(markdown、text、maxLength或contentFormat)、passage和html。 完整參數列表請參閱 API 參考資料。
lastUpdatedAt和crawledAt有什麼區別?
lastUpdatedAt 是發布者報告的內容更新日期,由網路搜尋、新聞、影片、圖片、瀏覽及自動在可用時回傳。
crawledAt 是 Web IQ 最後一次擷取由 Web Search、Browse、News 和 Auto 傳回之該頁面的時間。這兩個欄位的覆蓋率會因結果而異。
我應該如何調整 maxResults 和 maxLength,以管理上下文視窗和代幣成本?
Web IQ 可以優先處理與查詢相關的段落,而不是提供不必要的頁面上下文。 這可以減少傳給模型的文字量,並降低輸入標記成本。 優點取決於你的模型、提示詞、查詢組合和檢索設定。
對於大多數 grounding 情境,在總代幣預算大致相同的情況下,較多的結果搭配較短的段落,通常比少量結果搭配較長的段落產生更好的輸出。 一個不錯的起點是 maxResults=10,maxLength 約 3,000 個字元,採用 passage 格式。 用你自己的查詢和模型來做基準測試。
什麼是 Browse Live Crawl?我應該什麼時候使用它?
瀏覽會回傳 Bing 網頁索引的內容,隨著爬蟲觀察網路變化,索引會持續更新。 這就是網路搜尋的運作方式:搜尋結果是從索引中提供,而不是在每個請求中即時取得每個 URL,這也是 Browse 速度與一致性的關鍵。
對於需要即時擷取 URL 的情境,例如即時監控、競爭性檢查,或是在你知道剛發生變更時觸發的工作流程,Browse 支援 即時爬取。 在請求上設定 liveCrawl: "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 是否包含 SLA、RTO 或 RPO 承諾?
No. Microsoft Web IQ 不包含服務水準協議。 Web IQ 使用條款不承諾運作時間、延遲、恢復時間目標(RTO)或恢復點目標(RPO),且不會為個別客戶新增服務等級協議條款。
我需要顯示引用嗎?
Yes. Web IQ 使用條款第 1 節(LLM 使用)要求標註來源,並附上指向每個用於顯示 LLM 內容的來源(靠近該內容)的連結。
- 只引用實際用來產生答案的來源。 如果 Web IQ 回傳 10 個結果,而你的模型用了 3 個,就顯示這 3 個。
- 引用必須與答案一同可見,且只需一次操作即可存取。 不要只短暫顯示它們,也不要把它們藏在多個螢幕後面,或要求使用者分別索取來源。
- 對於受限介面,如汽車、穿戴裝置、語音優先裝置或自助服務機,使用持久性的 QR 碼,該碼會導向到列出目前答案所用所有引用的頁面,或是顯示答案及可點擊引用的配套應用程式,或使用者可直接開啟的螢幕列表。
你可以將引用資料儲存在單一終端用戶的聊天歷史中,長達30天。 請參考下方的快取問題。
我的 AI 代理或應用程式能顯示多少來源內容?
Web IQ 使用條款附件 A 限制了從單一來源顯示的 Grounding 內容,不得超過 200 字元或網站擁有者或網站管理員指定上限中較小者。 對於語音或音訊體驗,也請將相同限制套用於語音輸出。 摘要與展示有額外限制。 在設計摘錄前,請先閱讀使用條款;此限制並非允許重現整個原始頁面。
影像和影片的結果可以用來作為 LLM 的依據嗎?
影像與影片元資料及替代文字包含在「Grounding 內容」的定義中。 然而,Web IQ 使用條款禁止使用結果中的實際影像或影片用於 grounding、將其包含在大型語言模型輸出中,或以其製作衍生影像或影片。 請審閱您預期實施的相關規定。
我可以快取或儲存 Web IQ 內容嗎?
一般來說,不是。 Web IQ 使用條款禁止複製、儲存、快取、存檔或建立內容資料庫,除非有狹義例外情況(第 3.2.15 節以及附件 A 與附件 B 的第 4 節):
- 終端用戶聊天紀錄(最多 30 天):內容可依非彙總方式,按每位終端用戶儲存其聊天紀錄,最多可保存 30 天。 關於大型語言模型(LLM)使用(附件 A),涵蓋一般內容;在搜尋用途(附件 B)中,涵蓋圖片和影片網址。
- 原子行動暫時處理:內容僅在完成由大型語言模型(LLM)發起的單一邏輯請求或工作流程(稱為「原子行動」,可能涉及多個內部步驟或代理互動)時,才會被暫時處理。 原子行動完成後,內容必須立即刪除。
- 您自己的工作成果:在著作權法允許的範圍內,內容可作為您作品的一部分複製或儲存,前提是該工作成果並非為了取代服務而創建(例如建立內容資料庫、索引連結以進行爬取,或提供獨立搜尋服務)。
除上述例外外,使用條款不允許衍生資料庫、持續快取或內容長期存檔。
我在哪裡可以閱讀 Web IQ 使用條款?
目前的條款已於 Microsoft Web IQ 使用條款中公布。 它們會與你現有的 Microsoft 客戶合約 一起適用。
完整文件存取權
為什麼我設定 contentFormat 為 html時會出現 HTTP 403 錯誤?
在網頁搜尋與新聞搜尋中,text、html和markdown返回完整文件,且對擁有完整文件存取權的應用程式開放。 其他應用程式則會收到帶有錯誤代碼 AuthContentFormatForbidden的 HTTP 403。
passage 適用於所有應用程式。 請參閱 文章與內容格式。
我該如何申請完整文件存取權?
透過 Azure 支援開啟 Web IQ 支援請求,並選擇「全頁內容」類別。 已使用 html 或 text 的應用程式,仍會如同目前一樣繼續運作。