Note
Azure AI 搜尋服務 可透過 Azure 入口網站、REST API 及 Azure SDK 取得。 它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 Microsoft Foundry 入口網站中的代理使用。
代理檢索是一項按使用量計費的高級功能。 預設情況下，所有搜尋服務都加入免費方案，並提供免費的月費津貼。 若要在免費配額用盡後繼續使用，您可以切換到標準方案。
從 Search Service REST API 版本 2026-04-01開始，語意排名器與代理檢索的計費同意是分開的。 使用 knowledgeRetrieval 獨立控制付費代理檢索使用，不受 semanticSearch 影響。
先決條件
在任何提供 Agent 擷取功能的區域中的 Azure AI 搜尋服務。
擁有者 或 貢獻 者可使用搜尋服務。
搜尋管理 REST API 版本 2026-03-01-preview 或更新版本以設定該
knowledgeRetrieval屬性。
帳單分攤
你可以用搜尋管理 REST API 設定帳單同意。 下表顯示根據您的應用程式所使用的搜尋服務 REST API 版本，哪個屬性會生效。
| Search Service REST API 版本 | 語意排名器計費 | 代理檢索計費 |
|---|---|---|
| 2026-04-01 及之後 | 由 semanticSearch 控制 |
由 knowledgeRetrieval 控制 |
| 2025-11-01-預覽版 及更早 | 由 semanticSearch 控制 |
由 semanticSearch 控制 |
對於搜尋服務 REST API 版本 2026-04-01 及更新版本，knowledgeRetrieval 可獨立於 semanticSearch 控制代理式擷取的計費。 要控制語意排序計費，請參見 啟用或停用語意排序計費。
對於搜尋服務 REST API 版本 2025-11-01-preview 及更早版本，semanticSearch 會控制語意排序器和付費代理式擷取使用的同意設定。 該 knowledgeRetrieval 屬性已被忽略。
計費計畫
代理檢索有兩種計費方案。 關於按貨幣定價，請參見Azure AI 搜尋服務定價。
| 計畫 | 描述 | Availability |
|---|---|---|
| 免費（預設） | 每月免費提供代幣配額。 在免費使用額度耗盡後，任何會導致付費的請求都將返回需付款錯誤。 | 所有價格層級皆有販售。 |
| 標準 | 在每月免費津貼用罄後，採用按需付費的價格模式。 | 需要基本等級或更高等級。 |
啟用主動檢索計費
請依照以下步驟，將代理檢索轉換為標準計費方案。
在Azure 入口網站中，進入您的搜尋服務。
在 概覽 頁面，確保價格等級是基本或更高。
從左側窗格選擇 「設定>高級功能」。
在知識檢索中，選擇標準卡中的選擇方案。
停用代理檢索帳單
請依照以下步驟將agentic retrieval切換回免費計費方案。
在Azure 入口網站中，進入您的搜尋服務。
從左側窗格選擇 「設定>高級功能」。
在知識檢索中，選擇免費卡中的選擇方案。
