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

發行項
01/10/2025

在 Azure AI 搜尋中設定選擇性 AI 擴充管線時，您可以免費擴充少量檔，每個索引每天最多 20 筆交易。針對較大型且較頻繁的工作負載，您應該連結可計費的 Azure AI 多服務資源。

多服務帳戶提供 Azure AI 服務的集合，而不是個別服務。在 Azure AI 搜尋技能集中提供帳戶，可讓Microsoft向您收取使用這些服務的費用：

適用於影像分析、光學字元辨識（OCR）和多模式文字和影像內嵌的 Azure AI 視覺。
Azure AI 語言，適用於語言偵測、實體辨識、情感分析和關鍵片語擷取
Azure AI 語音，適用於語音轉換文字和文字轉換語音
Azure AI 翻譯工具，適用於機器文字翻譯

您必須在技能集中將連線資訊提供給 Azure AI 多資源。 Azure AI 搜尋不會針對技能集工作負載使用連線，但會使用聯機來存取資源上的計費計量。因此，您的 Azure AI 服務帳戶會用於計費，而不是技能處理。 Azure AI 搜尋會使用個別的專用資源來處理技能。

您可以在連線上使用密鑰，或實作目前處於預覽狀態的無索引鍵方法。

提示

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

必要條件

除非您的搜尋服務符合 Azure AI 多服務帳戶私人連線的建立日期、層和區域需求，否則可透過公用端點進行連線。

注意

如果您的 Azure AI 資源設定為使用私人端點，則如果搜尋服務是在 2024 年 4 月 3 日之後建立，且位於提供較高容量運算能力且位於支援層的區域，Azure AI 搜尋可以使用共用的私人鏈接進行連線。如需詳細資訊，請參閱使用共用私人連結的需求。

透過無密鑰連線計費

注意

此功能目前處於公開預覽。此預覽版是在沒有服務等級協定的情況下提供，不建議用於生產工作負載。可能不支援特定功能，或可能已經限制功能。如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

您可以使用 Azure 入口網站或更新版本的預覽 REST API 和 Beta SDK 套件，使用受控識別和許可權連結 Azure AI 多服務資源。這種方法的優點是計費是無密鑰的，而且與區域沒有相依性。

設定 Azure AI 搜尋以使用受控識別。
在您的 Azure AI 多服務資源上，將身分識別指派給 認知服務使用者 角色。
使用 Azure 入口網站或 Skillset 2024-11-01-preview REST API，或提供語法的 Azure SDK Beta 套件，設定技能集以使用身分識別：
- 線上上使用的受控識別屬於搜尋服務。
- 身分識別可以是系統管理或使用者指派。
- 身分識別必須具有 Azure AI 資源的認知服務用戶 許可權。
- @odata.type 一律 #Microsoft.Azure.Search.AIServicesByIdentity為。
- subdomainUrl 是 Azure AI 多服務資源的端點。它可以位於 Azure AI 搜尋和 Azure AI 服務共同支援的任何區域中。

如同密鑰，您提供 Azure AI 服務資源的詳細資料會用於計費，而不是連線。 Azure AI 搜尋服務對 Azure AI 服務提出的所有 API 要求，以供內建技能處理繼續由Microsoft進行內部和管理。

子域 URL 必須包含唯一的名稱（例如， https://hereismyuniquename.cognitiveservices.azure.com。如果服務是透過 Azure 入口網站建立的，系統會自動產生唯一的子域作為服務設定的一部分。請確定您的服務包含唯一的子域，再搭配 Azure AI 搜尋整合使用。

範例：系統指派的受控識別

身分識別會設定為 null。

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
}

範例：使用者指派的受控識別

身分識別會設定為使用者指派受控識別的資源標識碼。若要尋找現有的使用者指派受控識別，請參閱管理使用者指派的受控識別。

針對使用者指派的受控識別，請設定 @odata.type 和 userAssignedIdentity 屬性。

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.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 搜尋也可以使用 Azure AI 多服務資源密鑰來收取交易費用。此方法是預設值，而且已正式推出。您可以使用 Azure 入口網站、REST API 或 Azure SDK，將密鑰新增至技能集。

有兩種支援的金鑰類型： #Microsoft.Azure.Search.CognitiveServicesByKey 其會呼叫區域端點，以及 "#Microsoft.Azure.Search.AIServicesByKey 呼叫子域。我們建議使用 AIServicesByKey 來提供其共用私人連結支援，並能夠在與搜尋服務相關的區域需求下運作。

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

登入 Azure 入口網站。
在與您搜尋服務相同的區域中建立 Azure AI 多服務資源。
從 [資源>金鑰和端點] 頁面取得資源金鑰。
將金鑰新增至技能定義：
- 如果使用匯入數據精靈，請建立或選取 Azure AI 帳戶。精靈會將資源金鑰新增至您的技能集定義。
- 針對新的或現有的技能集，提供技能集定義中的索引鍵。

注意

Azure 入口網站目前會自動附加類型的#Microsoft.Azure.Search.CognitiveServicesByKey索引鍵。

使用建立或更新 Skillset API，指定 cognitiveServices 要求主體中的區段：

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-11-01-Preview
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.AIServicesByKey",
        "description": "mycogsvcs",
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
        "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 入口網站。
在 [搜尋管理>技能集] 下，從清單中選取技能集。
捲動至包含 "cognitiveServices"的檔案中的區段。
從 JSON 刪除索引鍵值，並儲存技能集。

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

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

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-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 呼叫時，計費就會生效。您可以重設索引器來重設 API 計數。

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

索引器可以設定為在私人執行環境中執行，以便只使用您自己的搜尋服務的搜尋節點進行專用處理。即使您使用的是私人執行環境，Azure AI 搜尋仍會使用其內部布建的 Azure AI 多服務資源來執行所有技能擴充。

注意

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

公用連線需求

根據您的搜尋服務建立時間及其階層和區域，內建技能的計費可能需要從 Azure AI 搜尋服務到 Azure AI 多重服務的公用連線。停用公用網路存取會中斷某些案例的計費。檢閱透過共用私人連結連線的需求，以判斷您的搜尋服務是否需要公用連線。

如果您無法使用公用網路，您可以設定使用支援私人端點的 Azure 函式實作的自訂 Web API 技能，並將 Azure AI 服務資源新增至相同的 VNET。如此一來，您就可以使用私人端點直接從自訂技能呼叫 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 元。

共用方式為