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

Важно!

Служба LUIS будет прекращена 1 октября 2025 г., и с 1 апреля 2023 г. вы не сможете создавать новые ресурсы LUIS. Мы рекомендуем перенести приложения LUIS на распознавание устной речи , чтобы воспользоваться непрерывной поддержкой продуктов и многоязычными возможностями.

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

Ресурс разработки

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

• 1 миллион транзакций разработки.
• 1000 запросов к конечной точке прогнозирования с целью тестирования в месяц.

Чтобы управлять ресурсами разработки, можно использовать программные интерфейсы API LUIS 3.0 (предварительная версия).

Ресурс для прогнозирования

Ресурс прогнозирования позволяет направлять конечной точке прогнозирования более 1000 запросов (в отличие от ресурса разработки). У ресурсов прогнозирования две ценовые категории:

• Бесплатный ресурс прогнозирования (F0), для которого доступно 10 000 запросов к конечной точке прогнозирования в месяц.
• Ресурс прогнозирования категории "Стандартный" (S0). За него взимается плата.

Чтобы управлять ресурсами прогнозирования, можно использовать программный интерфейс API LUIS 3.0 (предварительная версия).

Примечание

• Вы также можете использовать ресурс с несколькими службами , чтобы получить одну конечную точку, используемую для нескольких служб ИИ Azure.
• LUIS предоставляет два типа бесплатных ресурсов (F0): один для транзакций разработки и один для транзакций прогнозирования. Если у вас заканчивается квота на бесплатные транзакции прогнозирования, убедитесь, что вы используете ресурс прогнозирования F0, который позволяет ежемесячно выполнять до 10 000 бесплатных транзакций, а не ресурс разработки, который позволяет ежемесячно выполнять до 1000 транзакций прогнозирования.
• Приложения LUIS следует разрабатывать в регионах, где планируется публикация и выполнение запросов.

Создание ресурсов LUIS

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

Портал LUIS

Создание ресурса LUIS для разработки с помощью портала LUIS

1. Войдите на портал LUIS, выберите свою страну или регион и примите условия использования. Если на портале отображается раздел Мои приложения, ресурс LUIS уже существует, и следующий шаг можно пропустить.

2. В открывшемся окне Выбор ресурса разработки найдите свою подписку Azure и ресурс разработки LUIS. Если у вас нет ресурса, можно его создать.

   

   При создании ресурса разработки укажите следующие сведения:

   • Имя клиента. Клиент, с которым связана подписка Azure.
   • Имя подписки Azure. Подписка, для которой будет выставлен счет за ресурс.
   • Имя группы ресурсов Azure. Выбранное или созданное пользователем имя группы ресурсов. Группы ресурсов позволяют группировать ресурсы Azure для осуществления доступа и управления.
   • Имя ресурса Azure. Выбранное пользователем имя, используемое в качестве части URL-адреса для запросов к конечной точки разработки и прогнозирования.
   • Ценовая категория. Ценовая категория определяет максимальное количество транзакций в секунду и месяц.

Создание ресурса LUIS для прогнозирования с помощью портала LUIS

1. В приложении перейдите на вкладку Управление.

2. В левой области навигации выберите Ресурсы Azure.

3. Нажмите кнопку Добавить ресурс прогнозирования .

   

   Если у вас уже есть ресурс прогнозирования, добавьте его. В противном случае выберите Создать ресурс прогнозирования.

   

Без портала LUIS

Создание ресурсов LUIS без использования портала LUIS

Используйте Azure CLI, чтобы отдельно создать каждый ресурс.

Совет

• Для ресурса разработки параметр kind принимает значение LUIS.Authoring.
• Для ресурса прогнозирования параметр kind принимает значение LUIS.

1. Войдите в Azure CLI:

   az login
   

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

2. Создайте ресурс разработки LUIS типа LUIS.Authoring с именем my-luis-authoring-resource. Создайте его в существующей группе ресурсов с именем my-resource-group для региона westus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Создайте ресурс конечной точки прогнозирования LUIS типа LUIS с именем my-luis-prediction-resource. Создайте его в существующей группе ресурсов с именем my-resource-group для региона westus. Если вас не устраивает пропускная способность бесплатной категории, измените категорию с F0 на S0. Дополнительные сведения о ценовых категориях и пропускной способности.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

Назначение ресурсов LUIS

Чтобы использовать ресурс, недостаточно просто его создать, его необходимо назначить приложениям. Ресурс разработки можно назначить одному или всем приложениям в LUIS.

Портал LUIS

Назначение ресурсов с помощью портала LUIS

Назначение ресурса разработки всем приложениям

Следующая процедура позволяет назначить ресурс разработки всем приложениям.

1. Войдите на портал LUIS.
2. В правом верхнем углу выберите учетную запись пользователя, а затем — Настройки.
3. На странице Параметры пользователя выберите Add authoring resource (Добавить ресурс разработки) и укажите существующий ресурс. Щелкните Сохранить.

Назначение ресурса конкретному приложению

Следующая процедура позволяет назначить ресурс конкретному приложению.

1. Войдите на портал LUIS. Выберите приложение в списке Мои приложения.

2. Перейдите в раздел Управление>Ресурсы Azure:

   

3. На вкладке Ресурс прогнозирования или Ресурс разработки нажмите кнопку Add prediction resource (Добавить ресурс прогнозирования) или Add authoring resource (Добавить ресурс разработки).

4. Используйте поля формы, чтобы найти нужный ресурс, затем нажмите кнопку Сохранить.

Без портала LUIS

Назначение ресурса прогнозирования без использования портала LUIS

Для автоматизированных процессов, например конвейеров CI/CD, можно автоматизировать назначение ресурса LUIS приложению LUIS, выполнив следующие действия.

1. Получите маркер Azure Resource Manager, который представляет собой буквенно-цифровую строку символов. Срок действия этого маркера ограничен, поэтому его следует использовать сразу. Также можно использовать следующую команду Azure CLI.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. С помощью маркера запросите ресурсы среды выполнения LUIS в подписках. С помощью API получите учетную запись LUIS в Azure, к которой есть доступ у вашей учетной записи пользователя.

   Для этого API POST необходимо указать следующие значения.

   Заголовок	Значение
   Authorization	Значение Authorization равно Bearer {token}. Перед значением маркера должны находиться слово Bearer и пробел.
   Ocp-Apim-Subscription-Key	Ваш ключ разработки.

   API возвращает массив объектов JSON, соответствующих подпискам LUIS. Среди возвращаемых значений идентификатор подписки, имя группы ресурсов и имя ресурса в виде AccountName. Найдите в массиве один элемент, соответствующий ресурсу LUIS, который вы хотите назначить приложению LUIS.

3. С помощью API назначения учетных записей LUIS в Azure приложению назначьте маркер ресурсу LUIS.

   Для этого API POST необходимо указать следующие значения.

   Тип	Параметр	Значение
   Заголовок	Authorization	Значение Authorization равно Bearer {token}. Перед значением маркера должны находиться слово Bearer и пробел.
   Заголовок	Ocp-Apim-Subscription-Key	Ваш ключ разработки.
   Заголовок	Content-type	application/json
   Строка запроса	appid	Идентификатор приложения LUIS.
   Текст		{AzureSubscriptionId: идентификатор подписки; ResourceGroup: имя группы ресурсов, в которую входит ресурс прогнозирования; AccountName: имя ресурса прогнозирования}

   При успешном выполнении этот API возвращает 201 - created status.

Отмена назначения ресурса

При отмене назначения ресурса он не удаляется из Azure. Для него разрывается связь с LUIS.

Портал LUIS

Отмена назначения ресурсов с помощью портала LUIS

1. Войдите на портал LUIS и выберите приложение в списке Мои приложения.
2. Перейдите в раздел Управление>Ресурсы Azure.
3. Для ресурса нажмите кнопку Unassign resource (Отменить назначение ресурса).

Без портала LUIS

Отмена назначения ресурса прогнозирования без использования портала LUIS

1. Получите маркер Azure Resource Manager, который представляет собой буквенно-цифровую строку символов. Срок действия этого маркера ограничен, поэтому его следует использовать сразу. Также можно использовать следующую команду Azure CLI.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. С помощью маркера запросите ресурсы среды выполнения LUIS в подписках. Используйте API получения учетных записей LUIS в Azure, к которому есть доступ у вашей учетной записи пользователя.

   Для этого API POST необходимо указать следующие значения.

   Заголовок	Значение
   Authorization	Значение Authorization равно Bearer {token}. Перед значением маркера должны находиться слово Bearer и пробел.
   Ocp-Apim-Subscription-Key	Ваш ключ разработки.

   API возвращает массив объектов JSON, соответствующих подпискам LUIS. Среди возвращаемых значений идентификатор подписки, имя группы ресурсов и имя ресурса в виде AccountName. Найдите в массиве один элемент, соответствующий ресурсу LUIS, который вы хотите назначить приложению LUIS.

3. С помощью API отмены назначения учетных записей LUIS в Azure приложению назначьте маркер ресурсу LUIS.

   Для этого API DELETE необходимо указать следующие значения.

   Тип	Параметр	Значение
   Заголовок	Authorization	Значение Authorization равно Bearer {token}. Перед значением маркера должны находиться слово Bearer и пробел.
   Заголовок	Ocp-Apim-Subscription-Key	Ваш ключ разработки.
   Заголовок	Content-type	application/json
   Строка запроса	appid	Идентификатор приложения LUIS.
   Текст		{AzureSubscriptionId: идентификатор подписки; ResourceGroup: имя группы ресурсов, в которую входит ресурс прогнозирования; AccountName: имя ресурса прогнозирования}

   При успешном выполнении этот API возвращает 200 - OK status.

Право владения ресурсом

Ресурс Azure, например ресурс LUIS, принадлежит подписке, содержащей ресурс.

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

• Передать право владения подпиской.
• Экспортировать приложение LUIS в виде файла, а затем импортировать в другую подписку. Экспорт можно выполнить на странице Мои приложения портала LUIS.

Ограничения ресурсов

Ограничения на создание ключей разработки

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

Дополнительные сведения см. в статье об ограничении ресурсов.

Ошибки, связанные с ограничениями использования ключей

Ограничения использования зависят от ценовой категории.

При превышении квоты на количество транзакций в секунду вы получите ошибку HTTP 429. При превышении квоты на количество транзакций в месяц вы получите ошибку HTTP 403.

Изменение ценовой категории

1. На портале Azure перейдите в раздел Все ресурсы и выберите ресурс.

   

2. В меню слева выберите Ценовая категория, чтобы просмотреть доступные ценовые категории.

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

Просмотр метрик ресурса Azure

Просмотр сводки об использовании ресурсов Azure

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

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

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

Оповещение о пороговом значении "Всего транзакций"

Чтобы знать, когда будет достигнуто определенное пороговое значение транзакций (например, 10 000), можно создать оповещение.

1. В меню слева выберите Оповещения.

2. В строке меню сверху выберите Новое правило генерации оповещений.

   

3. Выберите Добавить условие.

   

4. Выберите пункт Всего вызовов.

   

5. Прокрутите вниз до раздела Логика оповещений, задайте необходимые атрибуты и нажмите кнопку Готово.

   

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

   

Сброс ключа разработки

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

Приложения, которые не были перенесены: ключ сброшен для всех приложений на портале LUIS. При создании приложения через веб-сайт разработки API необходимо изменить значение Ocp-Apim-Subscription-Key на новый ключ.

Повторное создание ключа Azure

На странице Ключи портала Azure можно повторно создать ключ Azure.

Право владение приложением, безопасность приложения и доступ к нему

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

Вы можете переместить приложение LUIS. Используйте следующие ресурсы, чтобы сделать это на портале Azure или с помощью Azure CLI.

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

Дальнейшие действия

• Дополнительные сведения о том, как использовать версии для управления жизненным циклом приложения.