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

發行項
05/13/2024

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

多服務資源會將一組 Azure AI 服務視為一個供應項目，而不是多項個別服務，並透過單一 API 金鑰授與存取權。此金鑰會在技能中指定，並讓 Microsoft 向您收取使用下列服務的費用：

Azure AI Vision，適用於影像分析和光學字元辨識 (OCR)
Azure AI 語言，適用於語言偵測、實體辨識、情感分析和關鍵片語擷取
Azure AI 語音，適用於語音轉換文字和文字轉換語音
Azure AI 翻譯工具，適用於機器文字翻譯

提示

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=2023-11-01
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 移除金鑰，並儲存技能。

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

拿掉定義主體中的金鑰，然後傳送要求：

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2023-11-01
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 視覺、翻譯工具和 Azure AI 語言為基礎的內建技能，呼叫 Azure AI 服務 API。

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

影像擷取是一項 Azure AI 搜尋作業，會在擴充前萃取文件時發生。影像擷取可在所有定價層上計費，惟免費層上的 20 個免費每日擷取除外。影像擷取費用適用於 Blob 內的影像檔、其他檔案 (PDF 和其他應用程式檔案) 中的內嵌影像，以及使用文件擷取所擷取的影像。如需影像擷取定價，請參閱 Azure AI 搜尋定價頁面。

提示

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

範例：預估成本

若要預估與 Azure AI 搜尋索引編製建立關聯的成本，請先了解平均文件樣貌，以便您能夠進行一些計算。例如，您可能會估算：

1,000 個 PDF。
各有 6 頁。
每頁各一個影像 (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 元。

全部加總後，就使用所述技能來擷取 1,000 個此類型的 PDF 文件而言，您將需支付大約美金 57.00 元。

共用方式為