Присоединение оплачиваемого ресурса к набору навыков в Поиск с использованием ИИ Azure

Если вы используете встроенные навыки для обогащения возможностей ИИ в Поиск с использованием ИИ Azure, вы можете дополнить небольшое количество документов бесплатно, до 20 транзакций на индекс в день. Для более крупных или более частых рабочих нагрузок необходимо подключить оплачиваемый ресурс Microsoft Foundry к skillset.

Поиск с использованием ИИ Azure использует выделенные, внутренние размещенные ресурсы для выполнения встроенных навыков, поддерживаемых средствами Foundry, и требует ресурса Foundry исключительно для выставления счетов. Исключением является Навык понимания контента Azure, который использует ваш ресурс как для выставления счетов, так и для обработки.

Ресурс Foundry предоставляет доступ к нескольким службам в инструменте Foundry Tools. При указании в наборе навыков Microsoft может взимать с вас плату за использование следующих служб:

• Azure Vision в средстве Foundry для анализа изображений, оптического распознавания символов (OCR) и многомодальных встраиваний.
• Azure Language in Foundry Tools для обнаружения языка, распознавания сущностей, анализа тональности и извлечения ключевых фраз.
• Azure Translator в инструментах Foundry для машинного перевода текста.

Обработка навыков оплачивается основной службе, обслуживающей каждый навык. Поиск с использованием ИИ Azure объединяет расходы за Средства Foundry в один ресурс в системе Foundry. Например, если вы используете Image Analysis и Language Detection, плата за Azure Vision и Azure Language отображается на том же счете для вашего ресурса Foundry. Все остальные ресурсы оплачиваются независимо.

Чтобы подключить ресурс Foundry, укажите сведения о подключении в наборе навыков. Вы можете использовать подход на основе ключей или без ключа.

Необходимые условия

• Подключение через общедоступную конечную точку, если служба поиска не соответствует дате создания, уровню и регионам требований для частных подключений к ресурсу Foundry.

• Ресурс Foundry с типом API AIServices. Вы можете проверить тип API на странице Overview на портале Azure:

  

Выставление счетов через бесключевое подключение

Для присоединения ресурса Foundry можно использовать управляемую идентификацию и разрешения. Преимущество этого подхода заключается в том, что выставление счетов осуществляется без использования ключей и не имеет региональных требований.

Как и в случае с ключами, сведения о ресурсе используются для выставления счетов, а не для подключений. Все запросы API, сделанные Поиск с использованием ИИ Azure к инструментам Foundry для обработки встроенных навыков, остаются внутренними и управляются компанией Microsoft.

Для выставления счетов через безключевое подключение:

1. В вашей службе Поиск с использованием ИИ Azure настройте управляемое удостоверение. Поддерживаются как удостоверения, назначаемые системой, так и назначаемые пользователем.

2. На ресурсе Foundry назначьте роль пользователя служб Cognitive Services управляемому удостоверению поисковой службы.

3. Настройте набор навыков для использования управляемого удостоверения. Вы можете использовать портал Azure, последнюю стабильную версию Skillsets — Create Or Update (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, доступный на странице Keys и Endpoint на портале Azure.

   • Другие свойства относятся к типу управляемого удостоверения, как показано в следующих примерах REST API.

   • Системно назначаемое управляемое удостоверение
   • Управляемое удостоверение, назначаемое пользователем

   Ниже приведен пример конфигурации набора навыков для системно назначенного управляемого идентификатора. В этом сценарии необходимо задать значение identitynull.

   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
     }
   }
   

Выставление счетов через ключ ресурса

По умолчанию Поиск с использованием ИИ Azure взимает плату за транзакции, используя ключ ресурса Foundry. Этот подход общедоступен. Вы можете использовать портал Azure, стабильную версию REST API или эквивалентную Azure SDK, чтобы добавить ключ в набор навыков.

Существует два поддерживаемых типа ключей:

• #Microsoft.Azure.Search.CognitiveServicesByKey вызывает региональную конечную точку.
• #Microsoft.Azure.Search.AIServicesByKey вызывает поддомен. Мы рекомендуем этот тип, так как он поддерживает общие частные ссылки и не имеет региональных требований относительно службы поиска.

Ресурс Foundry должен находиться в том же регионе, что и служба поиска. Выберите регион Поиск с использованием ИИ Azure, предоставляющий интеграцию Foundry Tools, который указывается столбцом обогащение ИИ. Дополнительные сведения о требованиях к тому же региону см. в разделе "Использование ключа".

Если вы не укажете свойство cognitiveServices, служба поиска попытается использовать бесплатные обогащения, которые доступны индексатору ежедневно. Выполнение оплачиваемых функций останавливается после 20 транзакций на один вызов индексатора, а в журнале выполнения индексатора отображается сообщение "Тайм-аут".

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}"
    }
}

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 транзакций, и сообщение "Тайм-аут" появляется в журнале выполнения индексатора, когда исчерпывается выделение.

Использование ключа

Выставление счетов вступает в силу, когда вызовы API к ресурсу Foundry превышают 20 вызовов API на индексатор в день. Индексатор можно сбросить для сброса количества API.

Подключения без ключей и на основе ключей используются для выставления счетов, но не для подключений, связанных с операциями обогащения.

Для подключений на основе ключей служба поиска подключается по внутренней сети к ресурсу Foundry, расположенному в том же физическом регионе. Большинство регионов, которые предлагают Поиск с использованием ИИ Azure также предлагают другие службы Azure. При попытке обогащения искусственного интеллекта в регионе, который не имеет обеих служб, вы увидите следующее сообщение: "Предоставленный ключ не является допустимым ключом типа CognitiveServices для региона службы поиска".

Для бесключевых подключений служба поиска аутентифицируется с использованием удостоверения личности и назначения ролей и направляется на ресурс Foundry. Указанный ресурс является полностью квалифицированным URI, и URI включает уникальный поддомен.

Индексаторы можно настроить для запуска в частной среде выполнения для выделенной обработки, используя только узлы поиска собственной службы поиска. Даже если вы используете частную среду выполнения, Поиск с использованием ИИ Azure по-прежнему использует свои внутренние подготовленные ресурсы для выполнения всех обогащений навыков.

Требования к общедоступному подключению

В зависимости от времени создания службы поиска, ценовой категории и региона, выставление счетов за встроенные навыки может требовать публичного подключения для Поиск с использованием ИИ Azure к ресурсу Foundry. Отключение выставления счетов через общедоступную сеть прерывает выставление счетов в некоторых сценариях. Просмотрите требования для подключений через общую приватную ссылку, чтобы определить, нуждается ли ваша служба поиска в общедоступного подключения.

Если вы не можете использовать общедоступную сеть, можно настроить навык веб-API Custom Web API, реализованный с помощью Azure Function, которая поддерживает частные конечные точки, и добавить ваш ресурс Foundry в ту же VNET. В этом сценарии можно вызвать ресурс Foundry непосредственно из пользовательского навыка с помощью частных конечных точек.

Ключевые требования: особые случаи

Custom Entity Lookup тарифицируется с помощью Поиск с использованием ИИ Azure, но для разблокировки транзакций, превышающих 20 на один индексатор в день, требуется ключ ресурса из Foundry. Только для этого навыка ключ доступа к ресурсу разблокирует количество транзакций, но никак не связан с выставлением счетов.

Бесплатные обогащения

Система обогащения на базе ИИ предоставляет небольшое количество бесплатной обработки обогащений, за которые обычно взимается плата, что позволяет выполнять короткие упражнения без привлечения внешнего ресурса. Бесплатные обогащения — это 20 документов на индексатор в день. Можно сбросить индексатор, чтобы обнулить счетчик, если вы хотите повторить упражнение.

Некоторые обогащения всегда бесплатны:

• Служебные навыки, которые не вызывают средства Foundry (а именно условное, извлечение документов, формирователь, слияние текста и разделение текста) не подлежат оплате.

• Извлечение текста из PDF-документов и других файлов приложений не подлежит оплате. Извлечение текста, которое происходит во время взлома документов, не является обогащением ИИ, но происходит во время обогащения ИИ и таким образом отмечается здесь.

Оплачиваемые обогащения

Во время обогащения ИИ Поиск с использованием ИИ Azure вызывает API для встроенных навыков, основанных на Azure Vision, Azure language и Azure Translator.

Оплачиваемые встроенные функции, которые осуществляют вызовы к внешним службам, включают:

• Связывание сущностей
• Распознавание сущностей
• Анализ изображений
• Извлечение ключевых фраз
• Обнаружение языка
• OCR
• Обнаружение персональных данных (PII)
• Настроения
• Перевод текста
• Мультимодальные встраивания Azure Vision

Векторизатор на основе модели многомодального внедрения Azure Vision, работающий в режиме query-time, также является платной услугой.

Извлечение изображений — это операция Поиск с использованием ИИ Azure, которая возникает при трещинах документов до обогащения. Извлечение изображений подлежит оплате во всех тарифных планах, за исключением 20 бесплатных ежедневных извлечений на бесплатном уровне. Затраты на извлечение изображений применяются к файлам изображений внутри BLOB-объектов, встроенным изображениям в другие файлы (PDF и другие файлы приложений) и изображениям, извлеченным с помощью Извлечения документов. Сведения о ценах на извлечение изображений см. на странице с ценами на Поиск с использованием ИИ Azure.

Пример. Оценка затрат

Цены, показанные в этом разделе, являются гипотетическими и используются для иллюстрации процесса оценки. Ваши затраты могут быть ниже. Сведения о фактической цене транзакций см. в разделе " Цены на средства Foundry".

Чтобы оценить затраты, связанные с индексированием Поиск с использованием ИИ Azure, начните с представления о том, как в среднем выглядит документ, чтобы провести некоторые расчеты. Например, можно приблизиться к следующему:

• 1000 PDF-файлов
• Шесть страниц каждая
• Одно изображение на страницу (6 000 изображений)
• 3000 символов на страницу

Предположим, что существует конвейер, включающий обработку документов каждого PDF-файла, извлечение текста и изображений, выполнение OCR изображений и распознавание сущностей организаций.

1. Для взлома документов с содержимым текста и изображения извлечение текста в настоящее время свободно. Для 6000 изображений предполагается$ 1 для каждых 1000 извлеченных изображений. Этот шаг стоит $6,00.

2. Для OCR 6 000 изображений на английском языке, когнитивная функция OCR использует лучший алгоритм (DescribeText). Предполагая стоимость 2,50 долл. США за 1000 изображений, которые необходимо проанализировать, вы платите $15,00 за этот шаг.

3. Для извлечения сущностей на одной странице будет три текстовые записи. Каждая запись составляет 1000 символов. Три текстовые записи на страницу умножены на 6000 страниц равны 18 000 текстовых записей. Предполагая 2,00 $ за 1 000 текстовых записей, этот шаг будет стоить 36,00 $.

Сложив все вместе, вы бы заплатили около $57,00, чтобы загрузить 1000 PDF-документов такого типа с описанным набором навыков.

Связанное содержимое

• Поиск с использованием ИИ Azure страница цен
• Как определить набор навыков
• Создание набора навыков (REST)
• Как сопоставлять обогащенные поля