Поделиться через


Присоединение ресурса служб искусственного интеллекта Azure к набору навыков в службе "Поиск ИИ Azure"

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

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

Ресурс нескольких служб ИИ Azure предоставляет коллекцию служб ИИ Azure, а не отдельных служб. Предоставление ресурса, предоставляющего несколько служб, в наборе навыков для Azure AI Search позволяет Microsoft взимать плату за использование этих служб.

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

Исключения для выставления счетов через ресурс с несколькими службами включают AzureOpenAIEmbedding или выставление счетов за навык AML. Поиск по искусственному интеллекту Azure не содержит внутренних моделей из Azure OpenAI или каталога моделей Azure AI Foundry. Использование навыков AML и векторизаторов Azure OpenAI выполняется через цены Azure OpenAI по мере использования и цены Azure Machine Learning по мере использования соответственно. Некоторые другие навыки, такие как разделение текста и слияние текста, не оплачиваются.

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

Совет

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

Предварительные условия

  • Подключение через общедоступную конечную точку, если ваша служба поиска не соответствует требованиям по дате создания, уровню и региону для частных подключений к многосервисному ресурсу служб ИИ Azure.
  • Ресурс azure AI с несколькими службами , созданный с помощью [портала Azure[(https://portal.azure.com) только).

Примечание.

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

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

Примечание.

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

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

  1. Настройте поиск ИИ Azure с использованием управляемой идентичности.

  2. На ресурсе нескольких служб ИИ Azure назначьте удостоверение роли пользователя Когнитивных Сервисов.

  3. С помощью портала Azure, API REST Skillset 2024-11-01-preview или более поздней версии, или бета-пакета SDK Azure, который предоставляет необходимый синтаксис, настройте комплект навыков для использования удостоверения.

    • Управляемое удостоверение, используемое в соединении, принадлежит службе поиска. Это может управляться системой или назначаться пользователем.

    • Удостоверение должно иметь разрешения пользователя Cognitive Services на ресурсЕ ИИ Azure.

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

    • subdomainUrl — это конечная точка для многосервисного ресурса ваших служб ИИ Azure. URL-адрес поддомена должен содержать уникальное имя (например, https://hereismyuniquename.cognitiveservices.azure.com). Если служба была создана с помощью портал Azure, уникальный поддомен автоматически создается в рамках настройки службы. Убедитесь, что служба включает уникальный поддомен перед его использованием с интеграцией поиска ИИ Azure.

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

Пример: назначаемое системой управляемое удостоверение

Идентичность установлена в нулевое значение.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
} 

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

Удостоверение имеет идентификатор ресурса управляемого удостоверения, назначаемого пользователем. Сведения о поиске существующего управляемого удостоверения, назначаемого пользователем, см. в статье "Управление назначаемыми пользователем управляемыми удостоверениями".

Для управляемого удостоверения, назначаемого пользователем, задайте @odata.type свойства и userAssignedIdentity свойства.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.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 также может взимать плату за транзакции с помощью ключа ресурса служб Azure AI с несколькими службами. Этот подход используется по умолчанию и общедоступен. Вы можете использовать портал Azure, REST API или пакет SDK Azure для добавления ключа в набор навыков.

Существует два поддерживаемых типа ключей: #Microsoft.Azure.Search.CognitiveServicesByKey вызывает региональную конечную точку и "#Microsoft.Azure.Search.AIServicesByKey вызывает поддомен. Рекомендуется использовать AIServicesByKey для поддержки общих приватных ссылок и возможности работать без региональных требований относительно службы поиска.

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

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

  1. Войдите на портал Azure.

  2. Создайте ресурс нескольких служб ИИ Azure в том же регионе , что и служба поиска.

  3. Получите ключ ресурса на странице Ресурсы>Ключи и конечная точка.

  4. Добавьте ключ в определение набора навыков:

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

    • Для нового или существующего набора навыков укажите ключ в определении набора навыков.

Снимок экрана ключевой страницы.

Примечание.

портал Azure автоматически присоединяет ключ типа#Microsoft.Azure.Search.CognitiveServicesByKey.

Удаление ключа

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

  1. Войдите на портал Azure.

  2. В разделе > навыков управления поиском" выберите набор навыков из списка.

    Снимок экрана страницы навыков.

  3. Прокрутите до раздела в файле, содержащего "cognitiveServices".

  4. Удалите значение ключа из JSON и сохраните набор навыков.

    Снимок экрана набора навыков JSON.

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

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

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

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

Для подключений без использования ключей служба поиска проходит проверку подлинности с помощью идентификации и назначения ролей, нацеливаясь на ресурс ИИ Azure для нескольких служб, указанный как полный универсальный идентификатор ресурса (URI), содержащий уникальный поддомен в этом URI.

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

Примечание.

Некоторые встроенные навыки основаны на нерегионарных службах ИИ Azure (например, навык перевода текста). Использование нерегионированного навыка означает, что ваш запрос может обслуживаться в регионе, отличном от региона поиска ИИ Azure. Для получения дополнительных сведений о нерегиональных службах см. страницу о продуктах служб ИИ Azure по регионам.

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

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

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

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

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

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

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

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

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

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

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

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

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

Совет

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

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

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

  • 1000 файлов PDF.
  • По шесть страниц каждый.
  • По одному изображению на странице (6000 изображений).
  • 3000 символов на одну страницу.

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

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

  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 с использованием указанного набора навыков.

Следующие шаги