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

發行項
04/30/2022

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

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

影像分析和光學字元辨識的電腦視覺 (OCR)
語言服務，用於語言偵測、實體辨識、情感分析和關鍵字組擷取
機器文字翻譯的翻譯工具

提示

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

設定資源金鑰

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

如果您未指定屬性，則每個索引子叫用的計費技能執行將會停止 20 筆交易，而「逾時」訊息會出現在索引子執行歷程記錄中。

登入 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);

如何使用金鑰

當對認知服務資源的 API 呼叫每天超過每個索引子 20 個 API 呼叫時，就會套用金鑰型計費。

金鑰用於計費，但不會用於連線。針對連線，搜尋服務會透過內部網路連線到位於相同實體區域的認知服務資源。提供認知搜尋的大部分區域也會提供認知服務。

如果您在沒有這兩項服務的區域中嘗試 AI 擴充，您會看到此訊息：「提供的金鑰不是搜尋服務區域的有效 CognitiveServices 類型金鑰」。

注意

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

重要需求特殊案例

自訂實體查閱是由Azure 認知搜尋計量，而不是認知服務，但需要認知服務資源金鑰，才能每天解除鎖定每個索引子超過 20 筆交易。針對此技能，資源金鑰只會解除封鎖交易數目，但與計費無關。

免費擴充

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

某些擴充一律是免費的：

未呼叫認知服務的公用程式技能 (也就是，條件式、檔擷取、 Shaper、文字合併和文字分割技能) 無法計費。
從 PDF 檔和其他應用程式檔擷取文字是不可計費的。文字擷取會在檔破解階段進行，而且不是個別的擴充，但會在 AI 擴充期間發生，因此會在這裡記下。

可計費擴充

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

可計費的內建技能，可對認知服務進行後端呼叫包括實體連結、實體辨識、影像分析、關鍵字組擷取、語言偵測、 OCR、 PII 偵測、情感和文字翻譯。

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

提示

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

範例：估計成本

若要估計與認知搜尋索引相關聯的成本，請從平均檔的外觀開始，讓您可以執行一些數位。例如，您可能大約：

1，000 個 PDF。
各有六個頁面。
每頁一個影像 (6，000 個影像) 。
每頁 3，000 個字元。

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

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

針對文字和影像內容的文件破解，目前文字擷取是免費功能。針對 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 檔，其中包含所述的技能集。