將 Azure AI 多服務資源附加至 Azure AI 搜尋中的技能集

發行項
01/11/2024

在 Azure AI 搜尋中設定選擇性的 AI 擴充管線時，您可以免費擴充有限的檔數目。針對較大型且更頻繁的工作負載，您應該附加可計費的 Azure AI 多服務資源。

多服務資源會參考一組 Azure AI 服務作為供應專案，而不是個別服務，並透過單一 API 密鑰授與存取權。此金鑰是在技能集中指定，可讓 Microsoft 向您收取使用這些服務的費用：

提示

Azure 提供基礎結構來監視計費和預算。如需監視 Azure AI 服務的詳細資訊，請參閱規劃和管理 Azure AI 服務的成本。

設定資源金鑰

您可以使用 Azure 入口網站、REST API 或 Azure SDK，將可計費資源附加至技能集。

如果您未指定屬性，您的搜尋服務會嘗試每天使用索引器可用的免費擴充。每個索引器調用的計費技能執行會停止 20 筆交易，而索引器執行歷程記錄中會出現「逾時」訊息。

登入 Azure 入口網站。
在與搜尋服務相同的區域中建立 Azure AI 多服務資源。
將金鑰新增至技能集定義：
- 如果使用匯入數據精靈，請在第二個步驟中輸入密鑰「新增 AI 擴充」。
- 如果將金鑰新增至新的或現有的技能集，請在 [Azure AI 服務] 索引標籤中提供金鑰。

在與搜尋服務相同的區域中建立 Azure AI 多服務資源。
建立或更新技能集，並在cognitiveServices技能集要求的主體中指定區段：

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

下列代碼段來自 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);

拿掉金鑰

擴充是可計費的作業。如果您不再需要呼叫 Azure AI 服務，請遵循這些指示來移除多重區域密鑰，並防止使用外部資源。如果沒有索引鍵，技能集會還原為每天每個索引器 20 個免費交易的默認配置。當配置用完時，可計費技能的執行會在 20 筆交易停止，且索引器執行歷程記錄中會出現「逾時」訊息。

Azure 入口網站
REST

登入 Azure 入口網站，然後開啟搜尋服務 [概觀] 頁面。
在 [技能集] 底下，選取包含您要移除之密鑰的技能集。
捲動至檔案的結尾。
從 JSON 移除金鑰，並儲存技能集。

取得 Skillset ，讓您可以擁有完整的定義。
制定更新技能集要求，並提供技能集的 JSON 定義。

拿掉定義主體中的索引鍵，然後傳送要求：

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": ""
    }
}

或者，您可以將 “cognitiveServices” 設定為 null：

"cognitiveServices": null,

金鑰的使用方式

當對 Azure AI 服務資源的 API 呼叫超過每天每個索引器 20 個 API 呼叫時，就會套用密鑰型計費。

密鑰用於計費，但不適用於擴充作業的連線。針對連線，搜尋服務會透過內部網路連線到位於相同實體區域的 Azure AI 服務資源。大部分提供 Azure AI 搜尋的區域也會提供其他 Azure AI 服務，例如 Language。如果您在沒有這兩個服務的區域中嘗試 AI 擴充，您會看到此訊息：「提供的密鑰不是搜尋服務區域的有效 CognitiveServices 類型密鑰。」

目前，內建技能的計費需要從 Azure AI 搜尋公用連線到另一個 Azure AI 服務。停用公用網路存取會中斷計費。如果停用公用網路是必要條件，您可以設定使用支援私人端點的 Azure 函式實作的自定義 Web API 技能，並將 Azure AI 服務資源新增至相同的 VNET。如此一來，您就可以使用私人端點直接從自定義技能呼叫 Azure AI 服務資源。

注意

某些內建技能是以非區域 Azure AI 服務為基礎（例如文字翻譯技能）。使用非區域技能表示您的要求可能會在 Azure AI 搜尋區域以外的區域中提供服務。如需非區域服務的詳細資訊，請參閱依區域排序的 Azure AI 服務產品頁面。

重要需求特殊案例

自定義實體查閱是由 Azure AI 搜尋所計量，而不是 Azure AI 服務，但它需要 Azure AI 多服務資源密鑰，才能解除鎖定每天超過 20 個索引器的交易。僅針對此技能，資源密鑰會解除封鎖交易數目，但與計費無關。

免費擴充

AI 擴充提供少量的免費可計費擴充處理，讓您可以完成簡短練習，而不需要附加 Azure AI 多服務資源。免費擴充是每天 20 份檔，每個索引器。如果您想要重複練習，可以重設索引器來重設計數器。

某些擴充一律是免費的：

不會呼叫 Azure AI 服務的公用程式技能（也就是條件式、檔擷取、形狀器、文字合併和文字分割技能）無法計費。
無法從 PDF 檔案和其他應用程式檔案擷取文字。文字擷取會在檔破解期間發生，不是 AI 擴充，而是在 AI 擴充期間發生，因此會在這裡指出。

可計費擴充

在 AI 擴充期間，Azure AI 搜尋會呼叫 Azure AI 服務 API，以取得以 Azure AI 視覺、翻譯工具和 Azure AI 語言為基礎的內建技能。

對 Azure AI 服務進行後端呼叫的可計費內建技能包括實體鏈接、實體辨識、影像分析、關鍵片語擷取、語言偵測、OCR、個人標識資訊（PII）偵測、情感和文字翻譯。

影像擷取是 Azure AI 搜尋作業，會在檔在擴充之前被破解時發生。映射擷取可在所有層級上計費，但免費層上的 20 個免費每日擷取除外。影像擷取成本適用於 Blob 內的影像檔案、其他檔案中的內嵌影像（PDF 和其他應用程式檔案），以及使用檔擷取擷取的影像。如需影像擷取定價，請參閱 Azure AI 搜尋定價頁面。

提示

若要降低技能集處理的成本，請啟用累加擴充（預覽）來快取並重複使用因技能集所做的變更而不會影響的任何擴充。快取需要 Azure 儲存體（請參閱定價，但如果可以重複使用現有的擴充，則技能集執行的累計成本較低，特別是針對使用影像擷取和分析的技能集。

範例：估計成本

若要預估與 Azure AI 搜尋服務索引建立關聯的成本，請從一般文件的外觀開始，以便執行一些數位。例如，您可能會大致上：

1,000 個 PDF。
各有六頁。
每頁一個影像（6,000 個影像）。
每頁 3,000 個字元。

假設管線包含檔破解的每個 PDF、影像和文字擷取、影像光學字元辨識（OCR）以及組織的實體辨識。

本文中顯示的價格是假設的。它們用來說明估計程式。您的成本可能較低。如需交易的實際價格，請參閱 Azure AI 服務定價。

對於文字和影像內容的檔破解，文字擷取目前是免費的。針對 6,000 個影像，假設每擷取 1,000 個影像 1 美元。此步驟的成本為 6.00 美元。
對於英文 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 檔，其中包含所述的技能集。