啟用或停用代理檢索計費

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 影響。

先決條件

  • 位於 支援區域 且採用支援定價層級的 Foundry IQ 服務,如 計費方案所述。

  • 透過 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 版或更新版本。

請依照以下步驟,將代理檢索轉換為標準計費方案。

  1. 前往 Azure 入口網站中的 Foundry IQ 服務。

  2. 在 概覽 頁面,確保價格等級是基本或更高。

  3. 從左側窗格選擇 「設定>高級功能」。

  4. 在知識檢索中,選擇標準卡中的選擇方案。

    Azure 入口網站中高級功能頁面的螢幕截圖,顯示已選擇的知識擷取標準方案。

停用代理檢索帳單

請依照以下步驟將agentic retrieval切換回免費計費方案。 自由方案僅適用於代理性檢索推理。

  1. 前往 Azure 入口網站中的 Foundry IQ 服務。

  2. 從左側窗格選擇 「設定>高級功能」。

  3. 在知識檢索中,選擇免費卡中的選擇方案。

    Azure 入口網站中 Premium 功能頁面的螢幕截圖,顯示已選取的「知識擷取免費方案」。