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

Внимание

Интеллектуальная служба распознавания речи (LUIS) будет полностью прекращена 31 марта 2026 года. Создание ресурсов LUIS недоступно. Начиная с 31 октября 2025 г. портал 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, к которой есть доступ у вашей учетной записи пользователя.

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

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

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

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

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

   Тип	Настройка	Значение
   Заголовок	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, к которому есть доступ у вашей учетной записи пользователя.

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

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

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

3. Назначьте маркер ресурсу LUIS, используя API отмены назначения учетной записи LUIS Azure из приложения.

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

   Тип	Настройка	Значение
   Заголовок	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.

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

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

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