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


Создание ресурсов 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

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

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

    Выберите тип ресурса разработки для службы

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

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

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

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

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

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

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

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

    Добавление ресурса прогнозирования с портала, 2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Снимок экрана: подписка LUIS на портале 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.

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

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