Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
使用 knowledgeRetrieval 服務屬性,選擇代理擷取要使用的免費或標準計費方案。 此方案與您的 Foundry IQ 服務的定價層級是分開的。 新的 Foundry IQ 服務預設採用免費方案,免費提供每月代幣額度,用於代理式檢索推理。 切換至標準方案以啟用付費檢索使用。
從 Search Service REST API 版本 2026-04-01開始,語意排名器與代理檢索的計費同意是分開的。 使用 knowledgeRetrieval 獨立控制付費代理檢索使用,不受 semanticSearch 影響。
先決條件
透過
Microsoft.Search/searchServices/write更新 Foundry IQ 服務的權限。 內建角色如 擁有者 與 貢獻者 提供此權限。 欲了解更多資訊,請參閱 基於角色的存取控制。搜尋管理 REST API 版本 2026-03-01-preview 或更新版本以設定該
knowledgeRetrieval屬性。
帳單分攤
使用支援的搜尋管理 REST API 版本設定帳單同意。 下表顯示根據您的擷取請求(資料平面)上搜尋服務 REST API 版本,哪個屬性會生效。
| Search Service REST API 版本 | 語意排名器計費 | 代理檢索計費 |
|---|---|---|
2026-04-01 以及之後 |
由 semanticSearch 控制 |
由 knowledgeRetrieval 控制 |
2025-11-01-preview 以及更早版本 |
由 semanticSearch 控制 |
由 semanticSearch 控制 |
對於搜尋服務 REST API 版本 2026-04-01 及更新版本,knowledgeRetrieval 可獨立於 semanticSearch 控制代理式擷取的計費。 要控制語意排序計費,請參見 啟用或停用語意排序計費。
對於搜尋服務 REST API 版本 2025-11-01-preview 及更早版本,semanticSearch 會控制語意排序器和付費代理式擷取使用的同意設定。 該 knowledgeRetrieval 屬性已被忽略。
計費計畫
此 knowledgeRetrieval 屬性支援兩種計費方案: free 以及 standard。 這兩個方案都不會改變服務的收費等級。 有關目前的費率與配額,請參閱 Foundry IQ 價格。
| 計畫 | 描述 | Availability |
|---|---|---|
| 免費(預設) | 每月免費提供代幣配額。 在免費使用完畢後,若會產生付費使用量的請求會回傳 HTTP 402(需付費)錯誤。 | 受支援的服務層級與地區限制。 |
| 標準 | 在每月免費津貼用罄後,採用按需付費的價格模式。 | 需要支援的 SKU。 |
啟用主動檢索計費
重要
如果您先前依賴 semanticSearch 來啟用付費自主代理檢索的使用,則必須先明確將 2026-04-01 設為 knowledgeRetrieval,然後才能將自主代理檢索工作負載移轉至 Search Service REST API 第 standard 版或更新版本。
請依照以下步驟,將代理檢索轉換為標準計費方案。
前往 Azure 入口網站中的 Foundry IQ 服務。
在 概覽 頁面,確保價格等級是基本或更高。
從左側窗格選擇 「設定>高級功能」。
在知識檢索中,選擇標準卡中的選擇方案。
停用代理檢索帳單
請依照以下步驟將agentic retrieval切換回免費計費方案。 自由方案僅適用於代理性檢索推理。
前往 Azure 入口網站中的 Foundry IQ 服務。
從左側窗格選擇 「設定>高級功能」。
在知識檢索中,選擇免費卡中的選擇方案。