在 Azure AI 搜尋服務中將可計費資源附加到技能組

註

Azure AI 搜尋服務可透過 Azure 入口網站、REST API 及 Azure SDK 取得。它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 Microsoft Foundry 入口網站中的代理使用。

如果你在 Azure AI 搜尋服務中使用內建的技能進行 AI 增益，你可以免費增益少量文件，每天每個索引最多可進行 20 筆交易。對於較大或較頻繁的工作負載，您應將可計費的 Microsoft Foundry 資源附加至技能集。

Azure AI 搜尋服務使用專用的內部託管資源來執行由 Foundry Tools 支援的內建技能，且僅需 Foundry 資源用於計費。例外是Azure 內容了解功能，它會使用您的資源來進行帳單和訊息處理。

Foundry 資源提供 Foundry 工具內多項服務的存取。當你在技能集中指定時，Microsoft 能夠收取你使用以下服務的費用：

Foundry Tools 中的 Azure Vision，用於影像分析、光學字元辨識 (OCR) 和多模態內嵌。
Azure Foundry Tools中的語言用於語言偵測、實體識別、情感分析及關鍵詞萃取。
Azure 翻譯工具在 Foundry Tools 中用於文字機器翻譯。

技能的處理會計入每項技能的基礎服務。 Azure AI 搜尋服務將 Foundry Tools 的收費整合到單一的 Foundry 資源中。例如，如果你使用影像分析和語言偵測技能，Azure視覺與Azure語言的費用會在同一張帳單上顯示你的 Foundry 資源。其他所有資源則獨立計費。

若要附上 Foundry 資源，請在技能集中提供連結資訊。你可以使用基於密鑰或無密鑰的方式。

先決條件

透過公用端點的連線能力，除非您的搜尋服務符合私人連線至 Foundry 資源的建立日期、層級和區域需求。
具有 API 種類的 AIServices。你可以在 Azure 入口網站的Overview頁面上查看資源的 API 類型：

註

如果你的 Foundry 資源設定為使用私有端點，Azure AI 搜尋服務可以使用共享私有連結連接。欲了解更多資訊，請參閱共享私有連結資源限制。或者，將搜尋服務與 Foundry 資源置於同一網路安全邊界，以將撥往 Foundry 資源的外撥通話保持在私人通道中。
從 2025-11-01-preview 開始，技能集支援 AIServices API 種類。先前的CognitiveServices與經典 Azure AI 多服務帳戶仍可使用，但對於新技能組，我們建議使用AIServices與 Foundry 資源。

透過無鑰匙連接進行收費

你可以使用管理身份和權限來附加 Foundry 資源。這種方式的優點是計費是無密鑰的，且沒有區域限制。

和金鑰一樣，您提供的資源細節是用於計費，而非連線使用。 Azure AI 搜尋服務對 Foundry Tools 的所有內建技能處理 API 請求，皆由 Microsoft 內部管理。

透過無鑰匙連接計費：

在你的Azure AI 搜尋服務服務中，配置管理身份。同時支援系統指派與使用者指派的身份。
在你的 Foundry 資源中，將認知服務使用者角色指派給搜尋服務的受控識別。

設定一個技能組來使用受管理身份。你可以使用 Azure 入口網站、最新穩定版的 Skillsets - Create Or Update（REST API），或是提供語法的 Azure SDK 套件。

@odata.type 總是 #Microsoft.Azure.Search.AIServicesByIdentity。
subdomainUrl 是你 Foundry 資源的端點。你可以使用 https://<resource-name>.services.ai.azure.com 或 https://<resource-name>.cognitiveservices.azure.com 格式，這兩者都可以在 Azure 入口網站的 Keys 和 Endpoint 頁面取得。
其他屬性則是特定於受管理身份類型，如以下 REST API 範例所示。

系統指派的管理身份
使用者指派的受管理的身分識別

這裡有一個系統指派的托管身份技能設定範例。在這種情況下，你必須設定 identity 為 null。

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{
  "name": "my-skillset",
  "skills": [
    // Skills definition goes here
  ],
  "cognitiveServices": {
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
    "description": "A sample configuration for a system-assigned managed identity.",
    "subdomainUrl": "https://[resource-name].services.ai.azure.com",
    "identity": null
  }
}

這裡有一個使用者指派管理身份的技能組設定範例。此情境中，您必須設定 identity 為使用者指定的管理身份的資源 ID。若要尋找現有的使用者指派管理身份，請參見「管理使用者指派的受管理身份」。

你也必須設定 [email protected] 和 identity.userAssignedIdentity 屬性。

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{ 
    "name": "my-skillset", 
    "skills":  
    [ 
      // Skills definition goes here
    ], 
    "cognitiveServices": { 
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity", 
        "description": "A sample configuration for a user-assigned managed identity.", 
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "identity": {   
            "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": "/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}" 
        }
    } 
}

透過資源金鑰計費

預設情況下，Azure AI 搜尋服務會對使用 Foundry 資源金鑰的交易收費。這種方法普遍可行。你可以使用 Azure 入口網站、穩定的 REST API 版本，或等效的 Azure SDK 來新增技能組的金鑰。

支援兩種金鑰類型：

#Microsoft.Azure.Search.CognitiveServicesByKey 呼叫區域端點。
#Microsoft.Azure.Search.AIServicesByKey 呼叫子網域。我們推薦這種類型，因為它支援共享私有連結，且沒有針對搜尋服務的區域性要求。

你的 Foundry 資源必須與搜尋服務在同一區域。選擇一個提供 Foundry 工具整合的 Azure AI 搜尋服務區域，該區域以 AI enrichment 欄位標示。欲了解更多關於同區域要求的資訊，請參閱「如何使用金鑰」。

如果您未指定 cognitiveServices 屬性，搜尋服務會嘗試使用索引子每天可用的免費擴充。可計費技能會在每個索引子引動過程達到 20 筆交易時停止執行，並在索引子執行歷程記錄中顯示「逾時」訊息。

登入 Azure 入口網站。
在與你的搜尋服務相同的區域建立一個 Foundry 資源。
從左側窗格選擇 資源管理>鍵與端點。
複製其中一把鑰匙。
將關鍵要素加入技能組定義中。
- 如果你正在使用 匯入資料 精靈，請選擇 Foundry 資源。巫師會把資源鑰匙加入你的技能組定義中。
- 對於新技能或現有技能，請提供技能組定義中的關鍵。

註

入口會自動附加類型為 #Microsoft.Azure.Search.CognitiveServicesByKey 的鑰匙。

使用 Skillsets - 建立或更新（REST API)，並在請求正文中指定該區塊。cognitiveServices

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json
{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "A sample configuration for key-based billing.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "key": "{your-billable-resource-key}"
    }
}

以下程式碼摘錄自 azure search-dotnet-samples 以求簡潔。

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
IConfigurationRoot configuration = builder.Build();

string searchServiceUri = configuration["SearchServiceUri"];
string adminApiKey = configuration["SearchServiceAdminApiKey"];
string cognitiveServicesKey = configuration["CognitiveServicesKey"];

SearchIndexerClient indexerClient = new SearchIndexerClient(new Uri(searchServiceUri), new AzureKeyCredential(adminApiKey));

// Create the skills
Console.WriteLine("Creating the skills...");
OcrSkill ocrSkill = CreateOcrSkill();
MergeSkill mergeSkill = CreateMergeSkill();

// Create the skillset
Console.WriteLine("Creating or updating the skillset...");
List<SearchIndexerSkill> skills = new List<SearchIndexerSkill>();
skills.Add(ocrSkill);
skills.Add(mergeSkill);

SearchIndexerSkillset skillset = CreateOrUpdateDemoSkillSet(indexerClient, skills, cognitiveServicesKey);

把鑰匙拿出來

擴充是可計費作業。如果您不再需要呼叫 Foundry Tools，請依照以下指示移除金鑰並避免使用 Foundry 資源。

如果沒有金鑰，技能會還原為每個索引子每天 20 筆免費交易的預設配置。可計費技能會在達到 20 筆交易時停止執行，用完配置時，會在索引子執行歷程記錄中顯示「逾時」訊息。

Azure portal
REST

在Azure 入口網站中，進入您的搜尋服務。
在 搜尋管理 > 技能組中，從列表中選擇一項技能組。
捲動到檔案中的該 "cognitiveServices" 區塊。
刪除 JSON 中的鍵值。
儲存技能。

使用 Skillsets - Get （REST API）來取得該技能組的 JSON 定義。
使用 Skillsets - Create Or Update（REST API）來構思包含 JSON 定義的更新請求。
從 JSON 定義的主體中移除該鍵。

發送請求。

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "An example of removing the key.",
        "key": ""
    }
}

或者，你也可以設定 cognitiveServices 為 null：

"cognitiveServices": null,

鑰匙的使用方式

當對 Foundry 資源的 API 呼叫超出每個索引器每日 20 次時，計費即生效。你可以重置索引器來重置 API 數量。

無密鑰與基於密鑰的連線用於計費，但不用於與濃縮操作相關的連接。

對於基於金鑰的連線，搜尋服務透過內部網路連接到位於同一物理區域的 Foundry 資源。大多數提供 Azure AI 搜尋服務的地區也提供其他 Azure 服務。如果你嘗試在沒有同時提供這兩種服務的區域進行 AI 豐富化，你會看到這個訊息：「所提供的金鑰並非你搜尋服務區域的有效 CognitiveServices 類型金鑰。」

對於無金鑰連線，搜尋服務會利用其身份與角色指派進行驗證，並鎖定 Foundry 資源。該資源被指定為完全合格的 URI，且該 URI 包含唯一的子網域。

索引器可以設定在私有執行環境中執行，僅使用你自己搜尋服務的搜尋節點進行專門處理。即使你使用私有執行環境，Azure AI 搜尋服務仍會利用內部配置的資源來執行所有技能強化。

註

部分內建技能，如文字翻譯技能，則是基於非區域性的 Foundry 工具服務。如果你使用非區域技能，你的請求可能會在與 Azure AI 搜尋服務區域不同的區域處理。欲了解更多非區域服務資訊，請參閱產品區域供應頁面。

公共連接要求

根據你的搜尋服務的創建時間、定價層級及地區，內建技能的計費可能需要從 Azure AI 搜尋服務到 Foundry 資源的一個公開連結。在某些情況下，關閉公共網路存取會破壞計費。請檢視透過共享私人連結連結的要求，以判斷您的搜尋服務是否需要公共連結。

如果你無法使用公共網路，你可以設定一個Custom Web API 技能，並用 Azure Function實作，支援 private endpoints並將你的 Foundry 資源加入同一個 VNET。在這種情況下，你可以直接用自訂技能呼叫你的 Foundry 資源，使用私有端點。

關鍵需求，特殊情況

Azure AI 搜尋服務會計量自訂實體查閱，但它需要 Foundry 資源金鑰，才能解除鎖定每個索引子每天超過 20 筆的交易。針對此技能，資源金鑰僅解鎖交易數量，而與計費無關。

免費增益功能

AI 擴充可讓您免費處理少量計費的擴充，讓您毋須附加外部資源即可完成簡短的練習。免費增益是每位索引者每天 20 份文件。如果你想重複練習，可以重置索引器來重置計數器。

有些豐富內容總是免費的：

不呼叫 Foundry 工具的實用技能（例如條件、文件擷取、成形器、文字合併和文字分割技能）則不需計費。
從 PDF 文件及其他應用程式檔案擷取文字不會產生費用。文字擷取發生在文件破解期間，並非 AI 豐富化，但它在 AI 豐富過程中發生，因此在此處特別說明。

可計費擴充

在 AI 強化過程中，Azure AI 搜尋服務呼叫基於Azure視覺、Azure語言與Azure 翻譯工具的內建技能 API。

可計費的內建技能，用於向外部服務進行後端通話，包括：

由 Azure Vision 多模態嵌入模型支持的查詢時間向量化器也是一種收費的增強功能。

影像擷取是 Azure AI 搜尋服務作業，會在文件於擴充前破解時發生。影像擷取在所有計價方案中都會收費，只有在免費方案中每天可免費提取 20 次。影像擷取費用適用於 blob 內的影像檔案、其他檔案中嵌入的影像（PDF 及其他應用程式檔案），以及使用文件擷取擷取的影像。關於影像擷取的價格，請參見 Azure AI 搜尋服務價格頁面。

提示

為降低技能集處理成本，啟用增量豐富（預覽）以快取並重用未受技能組變更影響的豐富內容。快取需要 Azure 儲存體 (請參閱定價)，但如果可以重複使用現有擴充，技能集執行的累計成本會較低，尤其是使用影像擷取和分析的技能集。

範例：估算成本

本節所示價格為假設性，用以說明估算過程。你的費用可能會更低。關於實際交易價格，請參見 Foundry Tools 定價。

要估算 Azure AI 搜尋服務索引相關的成本，先從一份平均文件長什麼樣開始，這樣你才能算出一些數字。例如，你可以大致描述：

1,000 份 PDF
每頁六頁
每頁一張圖片（6,000 張圖片）
每頁3,000字元

假設一條流程包含每份 PDF 的文件破解、圖片與文字擷取、圖片的 OCR，以及組織的實體識別。

對於文字和圖片內容的破解文件，目前文字擷取是免費的。對於 6,000 張影像，假設每擷取 1,000 張影像需支付 1 美元。這一步總共花費6美元。
對於6,000張英文影像的OCR，OCR認知技能使用最佳演算法（DescribeText）。假設每 1,000 張圖片分析成本為 2.50 美元，此步驟需支付 15.00 美元。
當進行實體擷取時，每頁會有總共三筆文字記錄。每條紀錄有1,000個字元。每頁三筆文字記錄乘以 6,000 頁，等於 18,000 筆文字記錄。假設每 1,000 筆文字記錄需支付 2.00 美元，此步驟成本為 36.00 美元。

綜合來看，根據上述技能，你要花大約 $57.00 才能匯入 1,000 份這類 PDF 文件。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-05-21