Краткое руководство. Создание ресурса с несколькими службами для служб ИИ Azure

Узнайте, как создать ресурс с несколькими службами ИИ и управлять ими. Ресурс с несколькими службами позволяет получить доступ к нескольким службам ИИ Azure с одним ключом и конечной точкой. Она также объединяет выставление счетов из используемых служб.

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

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

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

Поддерживаемые службы с ресурсом с несколькими службами

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

Служба Description
Значок Content ModeratorContent Moderator (прекращено) Определяйте потенциально оскорбительное или нежелательное содержимое.
значок Пользовательское визуальное распознаваниеПользовательское визуальное распознавание Настройка распознавания изображений для вашего бизнеса.
Значок аналитики документовАналитика документов Преобразуйте документы в интеллектуальные решения на основе данных.
Значок лицаРаспознавание лиц Определяйте и распознавайте людей и их эмоции на изображениях.
Значок языкаЯзык Создавайте приложения с помощью возможностей распознавания естественного языка в отрасли.
Значок Голосовые функции Речь в тексте, тексте в речь, перевод и распознавание говорящего.
значок ПереводчикПереводчик Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.
Значок визуального зренияЗрение Анализ содержимого в изображениях и видео.

Необходимые компоненты

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

Создание ресурса с несколькими службами

Ресурс с несколькими службами указан в разделе "Службы>искусственного интеллекта Azure Azure" с несколькими службами на портале. Чтобы создать ресурс с несколькими службами, выполните следующие инструкции:

  1. Выберите эту ссылку, чтобы создать ресурс с несколькими службами: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

  2. На странице Создание введите приведенные ниже сведения.

    Сведения о проекте Description
    Подписка Выберите одну из доступных подписок Azure.
    Группа ресурсов Группа ресурсов Azure, которая будет содержать ресурс служб ИИ Azure. Вы можете создать новую группу или добавить к имеющейся группе.
    Регион Расположение экземпляра службы ИИ Azure. Разные расположения могут увеличивать задержку, но не влияют на доступность среды выполнения ресурса.
    Имя Описательное имя ресурса служб ИИ Azure. Например, MyCognitiveServicesResource.
    Ценовая категория Стоимость учетной записи служб искусственного интеллекта Azure зависит от параметров, которые вы выбрали и используете. Дополнительные сведения см. на странице с ценами API-интерфейсов.

    Экран создания ресурса для нескольких служб

  3. При необходимости настройте другие параметры ресурса, прочтите и примите условия (в соответствии с требованиями), а затем выберите Просмотр и создание.

Совет

Если подписка не позволяет создавать ресурс служб искусственного интеллекта Azure, возможно, потребуется включить привилегию этого поставщика ресурсов Azure с помощью портал Azure, команды PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите владельца подписки или пользователя с ролью администратора завершить регистрацию или предоставить привилегии /register/action для вашей учетной записи.

Получение ключей для ресурса

  1. После успешного развертывания ресурса выберите Дальнейшие действия>Перейти к ресурсу.

    Экран получения ключей для ресурса

  2. В открывшейся области быстрого запуска доступны конечная точка ресурса и параметры управления ключами.

Настройка переменной среды для проверки подлинности

Приложение должно пройти проверку подлинности для доступа к ресурсам служб ИИ Azure. Чтобы задать переменную среды для ключа ресурса, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки. Чтобы задать COGNITIVE_SERVICE_KEY переменную среды, замените your-key одним из ключей ресурса.

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

Совет

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

PowerShell включает расширяемое решение, управление секретами для хранения безопасных строк на платформах, таких как Хранилище секретов или Azure KeyVault.

Сведения о настройке хранилища секретов для размещения безопасных строк см. в статье "Начало работы с хранилищем секретов". Затем используйте следующие примеры для хранения ключей API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Для тестовых сред можно использовать синтаксис PowerShell $Env: для задания переменной среды только для текущего сеанса или setx команды для сохранения переменной в сеансах. Помните, что эти значения хранятся в четком тексте в разделах реестра Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key
setx COGNITIVE_SERVICE_KEY your-key

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

Чтобы задать переменную среды для региона ресурсов службы "Речь", выполните те же действия. Задайте COGNITIVE_SERVICE_REGION регион ресурса. Например, westus.

Очистка ресурсов

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

  1. На портале Azure разверните меню слева, чтобы открыть меню служб, и выберите Resource Groups (Группы ресурсов), чтобы просмотреть список групп ресурсов.
  2. Найдите группу ресурсов, содержащую ресурс, который необходимо удалить.
  3. Если вы хотите удалить всю группу ресурсов, выберите имя группы ресурсов. Выберите Удалить группу ресурсов на следующей странице и подтвердите выбор.
  4. Если вы хотите удалить только ресурс служб искусственного интеллекта Azure, выберите группу ресурсов, чтобы просмотреть все ресурсы в ней. На следующей странице выберите ресурс, который требуется удалить, щелкните меню с многоточием для этой строки и выберите Удалить.

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

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

Необходимые компоненты

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Интерфейс командной строки Azure
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Установка Azure CLI и вход

Установите интерфейс командной строки Azure. Чтобы войти в локальную установку CLI, выполните команду az login:

az login

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

Создание новой группы ресурсов служб ИИ Azure

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

Выбор расположения группы ресурсов

Чтобы создать ресурс, для подписки должно быть доступно одно из расположений Azure. Список доступных расположений можно получить с помощью команды az account list-locations. Доступ к большинству служб ИИ Azure можно получить из нескольких расположений. Выберите ближайший вариант из тех расположений, которые доступны для службы.

Внимание

  • Помните расположение Azure, так как вам потребуется при вызове ресурсов служб искусственного интеллекта Azure.
  • Доступность некоторых служб ИИ Azure может отличаться по регионам. Дополнительные сведения см. на странице Доступность продуктов по регионам.
az account list-locations --query "[].{Region:name}" --out table

Создав расположение Azure, создайте новую группу ресурсов с помощью команды az group create в Azure CLI. В приведенном ниже примере замените расположение Azure westus2 одним из расположений Azure, доступных для вашей подписки.

az group create --name ai-services-resource-group --location westus2

Создание ресурса Служб ИИ Azure

Выбор службы и ценовой категории

При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU). Вы будете использовать эту и другую информацию в качестве параметров при создании ресурса.

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Список доступных служб ИИ Azure можно найти с помощью команды az cognitiveservices account list-type :

az cognitiveservices account list-kinds

Добавление нового ресурса в группу ресурсов

Чтобы создать и подписаться на новый ресурс служб искусственного интеллекта Azure, используйте команду az cognitiveservices account create . Эта команда добавляет новый платный ресурс в созданную ранее группу ресурсов. При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU) и расположение Azure.

С помощью следующей команды можно создать ресурс multi-service-resource уровня "Стандартный" S0 с несколькими службами.

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind CognitiveServices --sku F0 --location westus2 --yes

Совет

Если подписка не позволяет создавать ресурс служб искусственного интеллекта Azure, возможно, потребуется включить привилегию этого поставщика ресурсов Azure с помощью портал Azure, команды PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите владельца подписки или пользователя с ролью администратора завершить регистрацию или предоставить привилегии /register/action для вашей учетной записи.

Получение ключей для ресурса

Чтобы войти в локальную установку интерфейса командной строки (CLI), выполните команду az login.

az login

Используйте команду az cognitiveservices account key list, чтобы получить ключи для ресурса.

az cognitiveservices account keys list  --name multi-service-resource --resource-group ai-services-resource-group

Настройка переменной среды для проверки подлинности

Приложение должно пройти проверку подлинности для доступа к ресурсам служб ИИ Azure. Чтобы задать переменную среды для ключа ресурса, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки. Чтобы задать COGNITIVE_SERVICE_KEY переменную среды, замените your-key одним из ключей ресурса.

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

Совет

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

PowerShell включает расширяемое решение, управление секретами для хранения безопасных строк на платформах, таких как Хранилище секретов или Azure KeyVault.

Сведения о настройке хранилища секретов для размещения безопасных строк см. в статье "Начало работы с хранилищем секретов". Затем используйте следующие примеры для хранения ключей API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Для тестовых сред можно использовать синтаксис PowerShell $Env: для задания переменной среды только для текущего сеанса или setx команды для сохранения переменной в сеансах. Помните, что эти значения хранятся в четком тексте в разделах реестра Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key
setx COGNITIVE_SERVICE_KEY your-key

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

Чтобы задать переменную среды для региона ресурсов службы "Речь", выполните те же действия. Задайте COGNITIVE_SERVICE_REGION регион ресурса. Например, westus.

Ценовые категории и выставление счетов

Ценовые категории (и сумма в выставленных счетах) основаны на количестве отправленных вами транзакций с использованием данных аутентификации. Каждая ценовая категория определяет:

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

Получение сведений об использовании квоты для ресурса

Используйте команду az cognitiveservices account list-usage, чтобы получить использование ресурса.

az cognitiveservices account list-usage --name multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Очистка ресурсов

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

Команда az group delete позволяет удалить группу ресурсов и все связанные с ней ресурсы.

az group delete --name ai-services-resource-group

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

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

Необходимые компоненты

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Azure PowerShell
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Установка Azure PowerShell и вход

Установите Azure PowerShell. Чтобы войти, выполните команду Подключение-AzAccount:

Connect-AzAccount

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

Создание новой группы ресурсов служб ИИ Azure

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

Выбор расположения группы ресурсов

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

Внимание

  • Помните расположение Azure, так как вам потребуется при вызове ресурсов служб искусственного интеллекта Azure.
  • Доступность некоторых служб ИИ Azure может отличаться по регионам. Дополнительные сведения см. на странице Доступность продуктов по регионам.
Get-AzLocation | Select-Object -Property Location, DisplayName

После размещения Azure создайте новую группу ресурсов в Azure PowerShell с помощью команды New-AzResourceGroup . В приведенном ниже примере замените расположение Azure westus2 одним из расположений Azure, доступных для вашей подписки.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Создание ресурса Служб ИИ Azure

Выбор службы и ценовой категории

При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU). Вы будете использовать эту и другую информацию в качестве параметров при создании ресурса.

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Список доступных служб ИИ Azure можно найти с помощью команды Get-AzCognitiveServicesAccountType :

Get-AzCognitiveServicesAccountType

Добавление нового ресурса в группу ресурсов

Чтобы создать и подписаться на новый ресурс служб искусственного интеллекта Azure, используйте команду New-AzCognitiveServicesAccount . Эта команда добавляет новый платный ресурс в созданную ранее группу ресурсов. При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU) и расположение Azure.

С помощью следующей команды можно создать ресурс multi-service-resource уровня "Стандартный" S0 с несколькими службами.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type CognitiveServices -SkuName F0 -Location westus2

Совет

Если подписка не позволяет создавать ресурс служб искусственного интеллекта Azure, может потребоваться включить привилегию этого поставщика ресурсов Azure с помощью портал Azure, команды Azure PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите владельца подписки или пользователя с ролью администратора завершить регистрацию или предоставить привилегии /register/action для вашей учетной записи.

Получение ключей для ресурса

Используйте команду Get-AzCognitiveServicesAccountKey, чтобы получить ключи для ресурса.

Get-AzCognitiveServicesAccountKey -Name multi-service-resource -ResourceGroupName ai-services-resource-group

Настройка переменной среды для проверки подлинности

Приложение должно пройти проверку подлинности для доступа к ресурсам служб ИИ Azure. Чтобы задать переменную среды для ключа ресурса, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки. Чтобы задать COGNITIVE_SERVICE_KEY переменную среды, замените your-key одним из ключей ресурса.

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

Совет

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

PowerShell включает расширяемое решение, управление секретами для хранения безопасных строк на платформах, таких как Хранилище секретов или Azure KeyVault.

Сведения о настройке хранилища секретов для размещения безопасных строк см. в статье "Начало работы с хранилищем секретов". Затем используйте следующие примеры для хранения ключей API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Для тестовых сред можно использовать синтаксис PowerShell $Env: для задания переменной среды только для текущего сеанса или setx команды для сохранения переменной в сеансах. Помните, что эти значения хранятся в четком тексте в разделах реестра Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key
setx COGNITIVE_SERVICE_KEY your-key

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

Чтобы задать переменную среды для региона ресурсов службы "Речь", выполните те же действия. Задайте COGNITIVE_SERVICE_REGION регион ресурса. Например, westus.

Ценовые категории и выставление счетов

Ценовые категории (и сумма в выставленных счетах) основаны на количестве отправленных вами транзакций с использованием данных аутентификации. Каждая ценовая категория определяет:

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

Получение сведений об использовании квоты для ресурса

Используйте команду Get-AzCognitiveServicesAccountUsage, чтобы получить использование ресурса.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name multi-service-resource

Очистка ресурсов

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

Чтобы удалить группу ресурсов и связанные с ней ресурсы, используйте команду Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Справочная документация | Исходный код библиотеки | Пакет (NuGet) | Примеры

Предварительные требования C#

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Текущая версия .NET Core.
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Создание субъекта-службы Azure

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

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

Создание или изменение группы ресурсов

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

Создание нового приложения C#

Создайте приложение .NET Core. В окне консоли (cmd, PowerShell или Bash) выполните команду dotnet new, чтобы создать консольное приложение с именем azure-management-quickstart. Эта команда создает простой проект "Hello World" на языке C# с одним файлом исходного кода: program.cs.

dotnet new console -n azure-management-quickstart

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

dotnet build

Выходные данные сборки не должны содержать предупреждений или ошибок.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Установка клиентской библиотеки

В каталоге приложения установите клиентскую библиотеку управления Azure для .NET, используя следующую команду:

dotnet add package Azure.ResourceManager.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Если вы используете интегрированную среду разработки Visual Studio, клиентская библиотека доступна в виде загружаемого пакета NuGet.

Импорт библиотек

Откройте файл program.cs и добавьте следующие операторы using в начало файла:

using System;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

аутентификация клиента;

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

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Затем в методе Main используйте эти значения для создания объекта CognitiveServicesManagementClient. Этот объект необходим для всех операций управления Azure.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Вызов методов управления

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

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Создание ресурса служб ИИ Azure (C#)

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

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, resource_name, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Выбор службы и ценовой категории

При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU). Вы будете использовать эту и другую информацию в качестве параметров при создании ресурса. Список доступных служб ИИ Azure можно найти, вызвав следующий метод в скрипте:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Просмотр ресурсов

Чтобы просмотреть все ресурсы в учетной записи Azure (для всех групп ресурсов), используйте следующий метод:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Удаление ресурса

Следующий метод удаляет указанные ресурсы из заданной группы ресурсов.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Выполнение приложения

Запустите приложение из каталога приложения с помощью команды dotnet run.

dotnet run

Справочная документация | Исходный код библиотеки | Пакет (Maven).

Предварительные требования Java

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Текущая версия пакета средств разработки Java (JDK).
  • Средство сборки Gradle или другой диспетчер зависимостей.
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Создание субъекта-службы Azure

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

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

Создание или изменение группы ресурсов

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

Создание нового приложения Java

В окне консоли (например, cmd, PowerShell или Bash) создайте новый каталог для приложения и перейдите в него.

mkdir myapp && cd myapp

Выполните команду gradle init из рабочей папки. Эта команда создает необходимые файлы сборки для Gradle, включая build.gradle.kts, который используется во время выполнения для создания и настройки приложения.

gradle init --type basic

Когда появится запрос на выбор предметно-ориентированного языка, выберите Kotlin.

Выполните следующие команды из рабочего каталога:

mkdir -p src/main/java

Установка клиентской библиотеки

В этом кратком руководстве используется диспетчер зависимостей Gradle. Клиентскую библиотеку и информацию для других диспетчеров зависимостей можно найти в центральном репозитории Maven.

В файле проекта build.gradle.kts включите клиентскую библиотеку в качестве оператора implementation наряду с требуемыми подключаемыми модулями и параметрами.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Импорт библиотек

Перейдите к новой папке src/main/java и создайте файл с именем Management.java. Откройте его в предпочитаемом редакторе или интегрированной среде разработки и добавьте следующие операторы import:

import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.identity.*;
import com.azure.resourcemanager.cognitiveservices.*;
import com.azure.resourcemanager.cognitiveservices.implementation.*;
import com.azure.resourcemanager.cognitiveservices.models.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

аутентификация клиента;

Добавьте класс в файл Management.java, а затем добавьте в него следующие поля со значениями. Заполните эти значения, используя созданный субъект-службу и информацию учетной записи Azure.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/

private static String applicationId = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
private static String applicationSecret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Затем в методе main используйте эти значения для создания объекта CognitiveServicesManager. Этот объект необходим для всех операций управления Azure.

/* For more information see:
https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
*/

ClientSecretCredential credential = new ClientSecretCredentialBuilder()
    .clientId(applicationId)
    .clientSecret(applicationSecret)
    .tenantId(tenantId)
    .build();
AzureProfile profile = new AzureProfile(tenantId, subscriptionId, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credential, profile);

Вызов методов управления

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

String resourceName = "test_resource";
String resourceKind = "TextTranslation";
String resourceSku = "F0";
Region resourceRegion = Region.US_WEST;

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location US West.
String resourceId = create_resource (client, resourceName, resourceGroupName, resourceKind, resourceSku, resourceRegion);

// Uncomment this to list all resources for your Azure account.
// list_resources (client, resourceGroupName);

// Delete the resource.
delete_resource (client, resourceId);

/* NOTE: When you delete a resource, it is only soft-deleted. You must also purge it. Otherwise, if you try to create another
resource with the same name or custom subdomain, you will receive an error stating that such a resource already exists. */
purge_resource (client, resourceName, resourceGroupName, resourceRegion);

Создание ресурса служб искусственного интеллекта Azure (Java)

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

public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String resourceKind, String resourceSku, Region resourceRegion) {
    System.out.println ("Creating resource: " + resourceName + "...");

    /* NOTE: If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
    setter from the AccountProperties object. */
    Account result = client.accounts().define(resourceName)
        .withExistingResourceGroup(resourceGroupName)
        // Note: Do not call withRegion() first, as it does not exist on the Blank interface returned by define().
        .withRegion(resourceRegion)
        .withKind(resourceKind)
        .withSku(new Sku().withName(resourceSku))
        .withProperties(new AccountProperties().withCustomSubDomainName(subDomainName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

Выбор службы и ценовой категории

При создании ресурса необходимо знать, какой вид службы вы хотите использовать, а также выбрать ценовую категорию (или номер SKU). Вы будете использовать эту и другую информацию в качестве параметров при создании ресурса. Список доступных служб ИИ Azure можно найти, вызвав следующий метод:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    for (ResourceSku sku : skus.list()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Просмотр ресурсов

Чтобы просмотреть все ресурсы в учетной записи Azure (для всех групп ресурсов), используйте следующий метод:

public static void list_resources (CognitiveServicesManager client, String resourceGroupName) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (Account account : accounts.listByResourceGroup(resourceGroupName)) {
        System.out.println ("ID: " + account.id());
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ("Custom subdomain name: " + account.properties().customSubDomainName());
        System.out.println ();
    }
}

Удаление ресурса

Следующий метод удаляет указанные ресурсы из заданной группы ресурсов.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteById (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Справочная документация | Исходный код библиотеки | Пакет (npm) | Примеры

Предварительные требования JavaScript

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Текущая версия Node.js
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Создание субъекта-службы Azure

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

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

Создание или изменение группы ресурсов

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

Создание нового приложения Node.js

В окне консоли (например, cmd, PowerShell или Bash) создайте новый каталог для приложения и перейдите в него.

mkdir myapp && cd myapp

Выполните команду init, чтобы создать приложение узла с помощью файла package.json.

 init

Прежде чем начать, создайте файл с именем index.js.

Установка клиентской библиотеки

Установите следующие пакеты npm:

npm install @azure/arm-cognitiveservices
npm install @azure/identity

Файл package.json этого приложения будет дополнен зависимостями.

Импорт библиотек

Откройте скрипт index.js и импортируйте следующие библиотеки.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices @azure/identity
 */
var Arm = require("@azure/arm-cognitiveservices");
var Identity = require("@azure/identity");

аутентификация клиента;

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

const service_principal_application_id =
  "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Затем добавьте следующую функцию quickstart для выполнения основных действий программы. Первый блок кода конструирует объект CognitiveServicesManagementClient, используя переменные учетных данных, указанные выше. Этот объект необходим для всех операций управления Azure.

async function quickstart() {
  /* For more information see:
https://www.npmjs.com/package/@azure/arm-cognitiveservices/v/6.0.0
https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-a-service-principal-with-a-client-secret
*/
  const credentials = new Identity.ClientSecretCredential(
    tenant_id,
    service_principal_application_id,
    service_principal_secret
  );
  const client = new Arm.CognitiveServicesManagementClient(
    credentials,
    subscription_id
  );
  // Note Azure resources are also sometimes referred to as accounts.
  const accounts_client = client.accounts;
  const resource_skus_client = client.resourceSkus;
  const deleted_accounts_client = client.deletedAccounts;

Вызов функций управления

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

Создание ресурса служб ИИ Azure (Node.js)

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

async function create_resource(
  client,
  resource_name,
  resource_kind,
  resource_sku,
  resource_region
) {
  console.log("Creating resource: " + resource_name + "...");
  /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
  var parameters = {
    sku: { name: resource_sku },
    kind: resource_kind,
    location: resource_region,
    properties: { customSubDomainName: subdomain_name },
  };
  return client
    .beginCreateAndWait(resource_group_name, resource_name, parameters)
    .then((result) => {
      console.log("Resource created.");
      console.log();
      console.log("ID: " + result.id);
      console.log("Kind: " + result.kind);
      console.log();
    })
    .catch((err) => {
      console.log(err);
    });
}

Выбор службы и ценовой категории

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

async function list_available_kinds_skus_locations(client) {
  console.log("Available SKUs:");
  var result = client.list();
  console.log("Kind\tSKU Name\tSKU Tier\tLocations");
  for await (let item of result) {
    var locations = item.locations.join(",");
    console.log(item.kind + "\t" + item.name + "\t" + item.tier + "\t" + locations);
  }
}

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Просмотр ресурсов

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

async function list_resources(client) {
  console.log("Resources in resource group: " + resource_group_name);
  var result = client.listByResourceGroup(resource_group_name);
  for await (let item of result) {
    console.log(item);
    console.log();
  }
}

Удаление ресурса

Следующая функция удаляет указанные ресурсы из заданной группы ресурсов.

async function delete_resource(client, resource_name) {
  console.log("Deleting resource: " + resource_name + "...");
  await client.beginDeleteAndWait(resource_group_name, resource_name);
  console.log("Resource deleted.");
  console.log();
}

Выполнение приложения

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

try {
  quickstart();
} catch (error) {
  console.log(error);
}

Затем в окне консоли запустите приложение с помощью команды node.

node index.js

Справочная документация | Исходный код библиотеки | Пакет (PyPi) | Примеры

Предварительные требования Python

  • Действующая подписка Azure (создайте бесплатную учетную запись).
  • Python 3.x
  • Ваша учетная запись Azure должна иметь роль, назначенную Cognitive Services Contributor для того, чтобы вы согласились с ответственными условиями ИИ и создайте ресурс. Чтобы назначить эту роль своей учетной записи, следуйте инструкциям, описанным в документации по назначению ролей, или обратитесь к администратору.
  • Вы должны создать первые ресурсы Azure AI Face, Azure AI Language или Azure AI Vision из портал Azure, чтобы вы могли просмотреть и подтвердить условия. После этого можно создать ресурсы с помощью любого средства развертывания (например, пакета SDK, Azure CLI или шаблона ARM) в той же подписке Azure.

Создание субъекта-службы Azure

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

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

Создание или изменение группы ресурсов

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

Создание приложения Python

Создайте новое приложение Python в предпочитаемом редакторе или интегрированной среде разработки и перейдите к своему проекту в окне консоли.

Установка клиентской библиотеки

Клиентскую библиотеку можно установить с помощью следующей команды:

pip install azure-mgmt-cognitiveservices

Также установите библиотеку удостоверений Azure для поддержки проверки подлинности маркеров Microsoft Entra.

pip install azure-identity

Импорт библиотек

Откройте скрипт Python и импортируйте следующие библиотеки.

import time
from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import Account, Sku

аутентификация клиента;

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

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

# How many seconds to wait between checking the status of an async operation.
wait_time = 10

Затем добавьте следующий код для создания объекта CognitiveServicesManagementClient. Этот объект необходим для всех операций управления Azure.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Создание ресурса служб искусственного интеллекта Azure (Python)

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

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")

# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = Account(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })

    poller = client.accounts.begin_create(resource_group_name, resource_name, parameters)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Выбор службы и ценовой категории

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

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

В следующих таблицах содержатся сведения о продуктах и ценах на службы ИИ Azure.

Несколько служб

Service Вид
Несколько служб. Дополнительные сведения см. на странице цен. CognitiveServices

Зрение

Service Вид
Зрение ComputerVision
Ресурс прогнозирования службы "Пользовательское визуальное распознавание" CustomVision.Prediction
Ресурс обучения службы "Пользовательское визуальное распознавание" CustomVision.Training
Распознавание лиц Face
Интеллектуальный анализ документов FormRecognizer

Речь

Service Вид
Речь SpeechServices

Язык

Service Вид
Распознавание речи (LUIS) LUIS
QnA Maker QnAMaker
Язык TextAnalytics
Перевод текста TextTranslation

Decision

Service Вид
Детектор аномалий AnomalyDetector
Content Moderator ContentModerator
Персонализатор Personalizer

Azure OpenAI

Service Вид
Azure OpenAI OpenAI

Ценовые категории и выставление счетов

Ценовые категории (и сумма, которую вы выставляете) основаны на количестве транзакций, которые вы отправляете с помощью сведений о проверке подлинности. Каждая ценовая категория определяет:

  • Максимальное число разрешенных транзакций в секунду (TPS).
  • Функции службы, включенные в ценовой категории.
  • Стоимость предопределенного количества транзакций. Выше этого числа будет взиматься дополнительная плата, как указано в сведениях о ценах для вашей службы.

Примечание.

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

Просмотр ресурсов

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

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Удаление ресурса

Следующая функция удаляет указанные ресурсы из заданной группы ресурсов.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")

    poller = client.accounts.begin_delete(resource_group_name, resource_name)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource deleted.")

Вызов функций управления

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

resource_name = "test_resource"
resource_kind = "TextTranslation"
resource_sku = "F0"
resource_location = "Global"

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource(resource_name, resource_kind, resource_sku, resource_location)

# Uncomment this to list all resources for your Azure account.
#list_resources()

# Delete the resource.
delete_resource(resource_name)

# NOTE: Deleting a resource only soft-deletes it. To delete it permanently, you must purge it.
# Otherwise, if you later try to create a resource with the same name, you will receive the following error:
# azure.core.exceptions.ResourceExistsError: (FlagMustBeSetForRestore) An existing resource with ID '<your resource ID>' has been soft-deleted. To restore the resource, you must specify 'restore' to be 'true' in the property. If you don't want to restore existing resource, please purge it first.
# Code: FlagMustBeSetForRestore

# Purge the resource.
purge_resource(resource_name, resource_location)

Выполнение приложения

Запустите приложение из командной строки с помощью команды python.

python <your-script-name>.py

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

  • Теперь, когда у вас есть ресурс, вы можете пройти проверку подлинности запросов API в одном из поддерживаемых служб ИИ Azure.