将计费资源附加到Azure AI Search中的技能集

如果在 Azure AI Search 中使用内置技能进行AI 增强，您可以免费增强少量文档，每个索引每天最多可进行 20 次交易。对于更大或更频繁的工作负荷，应将 Azure AI 服务的可计费资源附加到 skillset。

Azure AI Search使用专用的内部托管资源来执行由Azure AI services支持的内置技能，并且仅需要一个Azure AI services资源用于计费。例外是 Azure 内容理解技能，该技能使用您的资源进行计费和处理。

Azure AI services资源提供对Azure AI services内多个服务的访问权限。在技能集中指定时，Microsoft能够为你收取以下服务的费用：

Azure视觉服务在Azure AI服务中用于图像分析、光学字符识别（OCR）和多模态嵌入。
Azure语言在Azure AI服务中用于语言检测、实体识别、情感分析和关键短语提取。
Azure AI 服务中的 Azure Translator 用于机器文本翻译。

技能集处理将对每个技能的基础服务进行计费。 Azure AI Search将Azure AI 服务的费用合并到单个Azure AI 服务资源中。例如，如果使用 Image Analysis 和 Language Detection 技能，Azure视觉和Azure语言的费用将出现在Azure AI services资源的同一帐单上。所有其他资源都是独立计费的。

若要连接 Azure AI 服务资源，请提供技能集中的连接信息。可以使用基于密钥的方法或无键方法，该方法目前以预览版提供。

先决条件

除非您的搜索服务满足 Azure AI 服务资源的创建日期、服务层和区域要求以便进行专用连接，否则将通过公共终结点进行连接。
具有 API 类型的 AIServices。可以在Azure门户中资源的 Overview 页上验证 API 类型：

注意

如果Azure AI services资源配置为使用专用终结点，Azure AI Search可以使用共享专用链接进行连接。有关详细信息，请参阅共享专用链接资源限制。
2025-11-01-preview 引入了对 AIServices API 类型的支持。以前的 CognitiveServices 和经典 Azure AI 多服务帐户继续工作，但对于新的技能集，我们建议使用 AIServices。

通过无钥连接进行计费

注意

此功能目前处于公开预览状态。此预览版未随附服务级别协议，建议不要用于生产工作负载。某些功能可能不受支持或者受限。有关详细信息，请参阅 Azure 预览版的使用条款。

可以使用托管标识和权限来附加一个 Azure AI 服务资源。此方法的优点是计费是无密钥的，并且没有区域要求。

与密钥一样，提供有关资源的详细信息用于计费，而不是连接。 Azure AI Search 对 Azure AI services 的内置技能处理所发出的所有 API 请求，保持在内部并由 Azure 进行管理。

若要通过无密钥连接计费：

在Azure AI Search服务上，配置托管标识。支持系统分配标识和用户分配标识。
在您的 AI 服务资源上，将 认知服务用户 角色分配给您的搜索服务的托管标识。

配置技能集以使用托管标识。可以使用 Azure 门户、最新预览版 Skillsets - 创建或更新（REST API），或提供语法的 Azure SDK beta 包。

@odata.type始终为 #Microsoft.Azure.Search.AIServicesByIdentity。
subdomainUrl 是 AI 服务资源的终结点。可以使用 https://<resource-name>.cognitiveservices.azure.cn 格式，这两种格式均在 Azure 门户中的 Keys 和 Endpoint 页上可用。

其他属性特定于托管标识的类型，如以下 REST API 示例所示。

系统分配的托管标识
用户分配的托管标识

下面是系统分配的托管标识的示例技能集配置。在此场景中，您必须将 identity 设置为 null。

POST https://[service-name].search.azure.cn/skillsets/[skillset-name]?api-version=2025-11-01-preview
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.",
    "identity": null
  }
}

下面是用户分配的托管标识的示例技能集配置。在此方案中，您必须将 identity 设置为用户分配的托管标识的资源 ID。若要查找现有的用户分配的托管标识，请参阅管理用户分配的托管标识。

还必须设置 identity.@odata.type 和 identity.userAssignedIdentity 属性。

POST https://[service-name].search.azure.cn/skillsets/[skillset-name]?api-version=2025-11-01-preview
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.", 
        "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 Search 会根据 Azure AI 服务资源的密钥对事务收费。此方法已正式发布。可以使用 Azure 门户、稳定的 REST API 版本或等效Azure SDK将密钥添加到技能集。

有两种受支持的密钥类型：

#Microsoft.Azure.Search.CognitiveServicesByKey调用区域终结点。
#Microsoft.Azure.Search.AIServicesByKey调用子域。建议使用此类型，因为它支持共享专用链接，并且与搜索服务没有区域要求。

Azure AI services资源必须与搜索服务位于同一区域。选择一个支持与 Azure AI 服务集成的 Azure AI 搜索区域，这由AI 增强列加以指示。有关同一区域要求的详细信息，请参阅如何使用密钥。

如果未指定 cognitiveServices 属性，搜索服务会尝试每天使用索引器可用的免费扩充。每次索引器调用达到 20 个事务时，将停止可计费技能的执行，并且索引器执行历史记录中会显示“超时”消息。

登录到 Azure 门户。
在搜索服务所在的同一区域中创建Azure AI services资源。
在左窗格中，选择 “资源管理>密钥和终结点”。
复制其中一个密钥。
将密钥添加到技能集定义。
- 如果使用 导入数据向导，请选择 Azure 人工智能服务的资源。该向导会将资源密钥添加到技能集定义。
- 对于新的或现有的技能集，请提供技能集定义中的密钥。

注意

门户会自动附加类型为 #Microsoft.Azure.Search.CognitiveServicesByKey 的密钥。

使用 Skillsets - 创建或更新（REST API），指定请求正文中的cognitiveServices部分。

PUT https://[service-name].search.azure.cn/skillsets/[skillset-name]?api-version=2025-09-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.",
        "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);

删除密钥

扩充是收费操作。如果不再需要调用Azure AI services，请按照这些说明删除密钥并阻止使用Azure AI services资源。

如果没有密钥，技能集将还原为默认分配，每天每个索引器可进行 20 次免费事务。执行可计费功能在达到 20 次交易时停止，当分配已用尽时，“索引器执行历史记录”中会显示“超时”消息。

Azure portal
休息

在 Azure 门户中，转到你的搜索服务。
在“搜索管理 > 技能集”下，从列表中选择技能集。
滚动到 "cognitiveServices" 文件中的分区。
从 JSON 中删除键值。
保存技能。

使用技能集 - 获取（REST API）检索技能集的 JSON 定义。
使用技能集 - 创建或更新（REST API）来使用 JSON 定义来构建更新请求。
从 JSON 定义的正文中删除密钥。

发送请求。

PUT https://[service-name].search.azure.cn/skillsets/[skillset-name]?api-version=2025-09-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,

如何使用密钥

当对 Azure AI services 资源的 API 调用超过每天每个索引程序 20 次时，计费开始生效。可以重置索引器以重置 API 计数。

无密钥连接和基于密钥的连接用于计费，但不适用于与扩充作相关的连接。

对于基于密钥的连接，搜索服务通过内部网络连接到位于相同物理区域的 Azure AI 服务资源。提供Azure AI Search的大多数区域也提供其他Azure服务。如果尝试在不同时具备这两种服务的区域中进行 AI 扩充，则会看到以下消息：“提供的密钥不是搜索服务区域的有效 CognitiveServices 类型密钥。”

对于无密钥连接，搜索服务使用其身份和角色分配进行身份验证，并以 Azure 人工智能服务资源为目标。资源指定为完全限定的 URI，URI 包含唯一的子域。

可以将索引器配置为在专用执行环境中运行，仅使用自己的搜索服务的搜索节点进行专用处理。即使使用的是专用执行环境，Azure AI Search仍使用其内部预配的资源来执行所有技能扩充。

注意

某些内置技能（如 Text Translation 技能）是基于非区域性的 Azure AI 服务。如果使用非区域技能，则请求可能会在不同于 Azure AI Search 区域的区域中得到服务。有关非区域服务的详细信息，请参阅 “按区域列出的产品可用性 ”页。

公共连接要求

根据搜索服务的创建时间、定价层级和所属区域，内置技能的计费可能需要从 Azure AI Search 到 Azure AI 服务资源的公共连接。在某些情况下，禁用公用网络访问会中断计费。查看通过共享专用链接进行连接的要求，以确定搜索服务是否需要公共连接。

如果无法使用公共网络，则可以配置一个使用 Azure 函数实现的自定义 Web API 技能，以支持私有终结点，并将你的 AI 服务资源添加到同一个 VNET。在这种情况下，您可以通过专用终结点直接从自定义技能调用 AI 服务资源。

关键需求的特殊情况

自定义实体查找按 Azure AI Search 计量，但它需要一个 Azure AI 服务资源密钥来解锁每个索引器每天超过 20 次的事务。仅针对这一技能，资源密钥解除事务数量限制，但与计费无关。

免费增值

AI 扩充提供少量免费处理可计费扩充，以便无需附加外部资源即可完成简短练习。免费增益是每个索引器每天可处理 20 个文档。如果你需要重复练习，可以重置索引器以重置计数器。

某些增强功能始终免费

不调用Azure AI services的实用工具技能（即 Conditional， Document Extract、Shaper、Text Merge 技能）不计费。
从 PDF 文档和其他应用程序文件提取文本是不计费的。文本提取（在文档破解期间发生）不是 AI 扩充，但在 AI 扩充期间发生，因此在此处注明。

可计费的扩充

在 AI 增强期间，Azure AI Search 调用基于 Azure Vision、Azure Language 和 Azure Translator 的内置技能 API。

对外部服务的后端调用的可计费内置技能包括：

查询时向量化器由 Azure Vision 多模式嵌入模型驱动，并且是一个可计费的增强功能。

图像提取是在文档被解压和分析后进行扩充之前发生的 Azure AI Search 的一项操作。图像提取在所有定价层上计费，免费层上的每日 20 次免费提取除外。图像提取成本适用于 Blob 中的图像文件、其他文件中嵌入的图像（PDF 和其他应用文件），以及使用文档提取提取的图像。有关图像提取定价，请参阅 Azure AI Search 定价页。

提示

为了降低技能组处理的成本，启用增量扩充以缓存和重复使用任何不受技能组更改影响的扩充。缓存需要Azure Storage（请参阅 pricing），但如果可以重复使用现有扩充，则技能组执行的累积成本较低，尤其是对于使用图像提取和分析的技能集。

示例：估算成本

本部分所示的价格是假设的，用于说明估算过程。你的成本可能更低。有关交易的实际价格，请参阅 Azure AI 服务定价。

若要大致估算 Azure AI Search 索引相关的成本，首先需要对平均文档的概念有一个了解，以便可以进行一些计算。例如，可以使用以下似近值：

1,000 个 PDF 文件
每个页面有六页
每页一张图像（6,000 张图像）
每页 3,000 个字符

假设一个管道，包括对每个 PDF 的文档破解、图像的 OCR、文本提取，以及对组织的实体识别。

破解包含文本和图像内容的文档时，文本提取目前是免费的。对于 6,000 个图像，假设每提取 1,000 个图像需要 $1。则此步骤的成本是 $6.00。
对于6000张包含英语文本的图像的OCR，OCR认知技能使用了最佳算法(DescribeText)。假设每分析 1,000 个图像的成本为 $2.50，则这一步需要支付 $15.00。
提取实体时，每页总共有 3 个文本记录。每条记录包含 1,000 个字符。每页 3 个文本记录 * 6,000 页 = 18,000 个文本记录。假设 1000 个文本记录的成本为 $2.00，则这一步的成本为 $36.00。

综合起来，使用上述技能组处理此类 PDF 文档 1,000 个时，需要支付大约 57.00 美元。

Last updated on 2026-04-22

共用方式為