Присоедините ресурс, подлежащий оплате, к набору навыков в службе "Azure AI Поиск"

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

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

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

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

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

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

Prerequisites

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

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

  

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

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

Как и в случае с ключами, сведения о ресурсе используются для выставления счетов, а не для подключений. Все запросы API, выполняемые службой Azure AI Search к инструментам Foundry для обработки встроенных навыков, остаются внутренними и управляются Майкрософт.

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

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

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

3. Настройте набор навыков для использования управляемого удостоверения. Вы можете использовать портал Azure, последнюю предварительную версию набора навыков — создание или обновление (REST API) или бета-версию пакета Пакета SDK Azure, который предоставляет синтаксис.

   • @odata.type #Microsoft.Azure.Search.AIServicesByIdentity всегда.

   • subdomainUrl — это конечная точка ресурса Foundry. Вы можете использовать https://<resource-name>.services.ai.azure.com или https://<resource-name>.cognitiveservices.azure.com формат, которые доступны на странице "Ключи" и "Конечная точка " на портале Azure.

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

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

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

     POST https://[service-name].search.windows.net/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
       }
     }
     

Выставление счетов с помощью ключа ресурса

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

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

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

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

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

PUT https://[service-name].search.windows.net/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}"
    }
}

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 AI продолжает использовать свои внутренние управляемые ресурсы для выполнения всех обогащений способностей.

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

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

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

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

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

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

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

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

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

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

Оплачиваемые улучшения

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

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

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

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

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

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

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

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

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

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

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

2. Для OCR 6000 образов на английском языке когнитивные навыки OCR используют наилучший алгоритм (DescribeText). При условии что 1000 изображений для анализа будет стоить 2,50 долл., вы выплатите 15,00 долл. за этот шаг.

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

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

Связанный контент

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