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

如果在 Azure AI 搜索中使用用于 AI 增强的内置技能，则每天每个索引最多可免费增强少量文档达 20 个事务。对于更大或更频繁的工作负荷，应将计费的 Azure Foundry 资源附加到技能集。

Azure AI 搜索使用专用的内部托管资源来执行由 Foundry 工具提供支持的内置技能，并且只需使用 Foundry 资源进行计费。例外情况是 Azure 内容理解功能，它使用您的资源进行计费和处理。

Foundry 资源提供对 Foundry 工具中的多个服务的访问权限。当您在技能集中指定时，Azure 可以向您收取下列服务的使用费用：

用于图像分析、光学字符识别（OCR）和多模式嵌入的 Foundry 工具中的 Azure 视觉。
用于语言检测、实体识别、情绪分析和关键短语提取的 Foundry 工具中的 Azure 语言。
用于机器文本翻译的 Foundry 工具中的 Azure 翻译器。

技能集处理将对每个技能的基础服务进行计费。 Azure AI 搜索将 Foundry 工具的费用合并到单个 Foundry 资源中。例如，如果使用图像分析和语言检测技能，Azure 视觉和 Azure 语言的费用会显示在 Foundry 资源的同一帐单上。所有其他资源都是独立计费的。

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

先决条件

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

注意

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

通过无密钥连接计费

注意

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

可以使用托管身份和权限来附加 Foundry 资源。此方法的优点是计费是无密钥的，并且没有区域要求。

与密钥一样，提供有关资源的详细信息用于计费，而不是连接。 Azure AI 搜索向 Foundry Tools 发出的用于内置技能处理的所有 API 请求都保留在内部并由 Azure 管理。

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

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

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

@odata.type 始终为 #Microsoft.Azure.Search.AIServicesByIdentity。
subdomainUrl 是 Foundry 资源的终结点。可以使用 https://<resource-name>.services.ai.azure.com 格式或 https://<resource-name>.cognitiveservices.azure.com 格式，这两者均可在 Azure 门户的“密钥”和“终结点”页上找到。

其他属性特定于托管标识的类型，如以下 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.",
    "subdomainUrl": "https://[resource-name].services.ai.azure.com",
    "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.", 
        "subdomainUrl": "https://[resource-name].services.ai.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 搜索使用 Foundry 资源的密钥对交易计费。此方法已正式发布。可以使用 Azure 门户、稳定的 REST API 版本或等效的 Azure SDK 将密钥添加到技能集。

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

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

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

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

Azure 门户
休息
.NET SDK

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

注意

门户会自动附加类型为#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.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "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);

删除密钥

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

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

Azure 门户
休息

登录 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,

如何使用密钥

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

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

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

对于无密钥认证连接，搜索服务通过其身份和角色分配进行身份验证，并连接到 Foundry 资源。资源指定为完全限定的 URI，URI 包含唯一的子域。

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

注意

一些内置技能（如文本翻译技能）基于非区域 Foundry 工具服务。如果使用非区域技能，则请求可能在与 Azure AI 搜索区域不同的区域中提供服务。有关非区域服务的详细信息，请参阅 “按区域列出的产品可用性 ”页。

公共连接要求

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

如果无法使用公用网络，可以配置一个使用支持专用终结点的 Azure 函数实现的自定义 Web API 技能，并将您的 Foundry 资源添加到同一 VNET。在此方案中，可以使用专用终结点直接从自定义技能调用 Foundry 资源。

关键要求特殊情况

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

免费扩充

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

有些扩充始终免费：

不调用 Foundry 工具（即条件、文档提取、整形程序、文本合并和文本拆分技能）的实用工具技能不可计费。
从 PDF 文档和其他应用程序文件提取文本是不计费的。文本提取（在文档破解期间发生）不是 AI 扩充，但在 AI 扩充期间发生，因此在此处注明。

可计费的扩充

在 AI 扩充期间，Azure AI 搜索会调用 API 以获取基于 Azure 视觉、Azure 语言和 Azure Translator 的内置技能。

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

Azure 视觉多模式嵌入模型支持的查询时向量器也是可计费的扩充。

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

提示

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

示例：估算成本

本部分所示的价格是假设的，用于说明估算过程。你的成本可能更低。有关交易实际价格，请查看 Foundry Tools 定价。

若要估算 Azure AI 搜索索引编制的相关成本，请先构想一下文档的大致结构，以便能够得出一些数字。例如，可以使用以下似近值：

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。

综合起来，在使用上述技能组引入 1,000 个此类 PDF 文档时，需要支付大约 $57.00。

Last updated on 2025-12-01

Compartir a través de