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

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

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

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

   

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

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

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

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

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

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

   

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

   

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

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

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

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

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

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

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

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

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

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

   

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

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

Назначение ресурса прогнозирования без использования портала 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.

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

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

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