你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将可计费资源关联到 Azure AI 搜索中的技能集

注意

Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。它也是 Foundry IQ 的基础；Foundry IQ 是一个托管式知识层，可将企业内容转化为供 Microsoft Foundry 门户中的智能体使用的、可复用且具备权限感知能力的知识库。

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

Azure AI 搜索使用专用的、内部托管的资源来执行由 Foundry 工具支持的内置技能，并且需要 Foundry 资源仅用于计费目的。例外情况是 Azure 内容理解技能，其使用你的资源来进行计费和处理。

Foundry 资源提供对 Foundry 工具中的多个服务的访问权限。当你在技能集中指定它时，Microsoft能够为使用以下服务向你收费：

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

技能集处理按每个技能的基础服务计费。 Azure AI 搜索将 Foundry 工具的费用帐单整合到单一的 Foundry 资源中。例如，如果使用 Image Analysis 和 Language Detection 技能，Azure视觉和Azure语言的费用会显示在 Foundry 资源的同一帐单上。所有其他资源都是独立计费的。

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

先决条件

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

注意

如果 Foundry 资源配置为使用专用终结点，Azure AI 搜索可以使用共享专用链接连接。有关详细信息，请参阅共享专用链接资源限制。或者，将搜索服务和 Foundry 资源放在同一网络安全边界内，以使发往 Foundry 资源的出站调用保留在专用通道中。
从 2025-11-01-preview 开始，技能集支持 AIServices API 类型。以前的 CognitiveServices 和经典 Azure AI 多服务帐户继续工作，但对于新的技能集，我们建议使用 AIServices 和 Foundry 资源。

通过无密钥连接计费

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

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

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

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

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

@odata.type始终为 #Microsoft.Azure.Search.AIServicesByIdentity。
subdomainUrl 是 Foundry 资源的终结点。可以使用 https://<resource-name>.services.ai.azure.com 或 https://<resource-name>.cognitiveservices.azure.com 格式，这两种格式均在 Azure 门户中的 Keys 和 Endpoint 页上可用。
其他属性特定于托管标识的类型，如以下 REST API 示例所示。

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

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

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
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。若要查找现有用户分配的托管标识，请参阅 “管理用户分配的托管标识”。

还必须设置 [email protected] 和 identity.userAssignedIdentity 属性。

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
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 门户。
在搜索服务所在的同一区域中创建 Foundry 资源。
在左窗格中，选择 “资源管理>密钥和终结点”。
复制其中一个密钥。
将密钥添加到技能集定义。
- 如果使用 导入数据 向导，请选择 Foundry 资源。该向导将资源密钥添加到技能集定义。
- 对于新的或现有的技能集，请提供技能集定义中的密钥。

注意

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

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

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-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 门户
REST

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

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

发送请求。

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-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 搜索调用基于 Azure Vision、Azure Language 和 Azure 翻译器的内置技能 API 接口。

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

查询时向量化工具由 Azure Vision 多模态嵌入模型提供支持，也是可计费的增值功能。

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

提示

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

示例：估算成本

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

若要估算与 Azure AI 搜索索引相关的成本，请首先了解典型文档的特征，从而进行一些计算。例如，你可能进行近似估算：

1,000 份 PDF
每个有 6 个页面
每页一张图像（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 美元。

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

反馈

此页面是否有帮助？

Last updated on 2026-07-03