Краткое руководство. Создание приложения на портале LUIS

В этом кратком руководстве описано, как создать приложение LUIS, которое использует предварительно созданную предметную область автоматизации дома для включения и отключения освещения и устройств. Эта предварительно созданная предметная область предоставляет для использования намерения, сущности и фразы. Затем попробуйте настроить приложение, добавив дополнительные намерения и сущности. Когда все будет готово, вы получите работающую в облаке конечную точку LUIS.

Вход на портал LUIS

Новому пользователю LUIS следует выполнить следующие действия:

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

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

   

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

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

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

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

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

Создавать и администрировать приложения можно на странице Мои приложения.

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

Чтобы создать приложение, щелкните + Создать приложение.

В появившемся окне введите следующую информацию:

Нажмите кнопку Готово.

Добавление готовой предметной области

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

1. В области навигации слева выберите Предварительно созданные предметные области.

2. Выполните поиск по фразе HomeAutomation.

3. Нажмите кнопку Add domain (Добавить предметную область) на карточке HomeAutomation.

   

   Когда предметная область будет успешно добавлена, в области предварительно созданных предметных областей отобразится кнопка Remove domain (Удалить предметную область).

Извлечение намерений и сущностей

1. Выберите Intents (Намерения) в области навигации слева, чтобы просмотреть намерения из домена HomeAutomation. Они включают примеры речевых фрагментов, например HomeAutomation.QueryState и HomeAutomation.SetDevice.

   Примечание.

   Намерение None (Нет) стандартно предоставляется всеми приложениями LUIS. Оно используется для обработки фраз, которые не соответствуют функциям приложения.

2. Выберите намерение HomeAutomation.TurnOff. Намерение содержит список речевых фрагментов с обозначенными сущностями.

   

3. Если вы хотите просмотреть сущности в приложении, выберите Entities (Сущности). Если выбрать одну из сущностей, например HomeAutomation.DeviceName , вы увидите список значений, связанных с ним.

   

Обучение приложения LUIS

Когда приложение будет заполнено намерениями, сущностями и речевыми фрагментами, его необходимо обучить, чтобы отразить внесенные изменения.

1. В верхней правой части веб-сайта LUIS нажмите кнопку Train (Обучить).

   

2. Обучение будет завершено, когда кнопка Обучение станет неактивной.

Тестирование приложения

После обучения можно выполнить тестирование приложения.

1. Выберите Тест в правом верхнем меню навигации.

2. Введите тестовый речевой фрагмент в области интерактивного тестирования и нажмите клавишу ВВОД. Например, Turn off the lights.

   В нашем примере Turn off the lights (Выключить свет) правильно распознано как намерение HomeAutomation.TurnOff.

   

3. Выберите Проверить, чтобы просмотреть дополнительные сведения о прогнозировании.

   

4. Закройте область тестирования.

Настройка приложения

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

Создание намерений

Добавление дополнительных намерений в приложение

1. В левом меню навигации выберите пункт Намерения.
2. Нажмите кнопку Создать
3. Введите имя намерения HomeAutomation.AddDeviceAlias и нажмите кнопку "Готово".

Создание сущностей

Добавление дополнительных сущностей в приложение

1. В меню навигации слева выберите пункт Сущности.
2. Нажмите кнопку Создать
3. Введите имя сущности HomeAutomation.DeviceAlias, выберите обучаемый компьютер в списке Тип и нажмите кнопку Создать.

Добавление примеров высказываний

Пример речевого фрагмента — это текст, который пользователь вводит в чат-бот или другое клиентское приложение. Они сопоставляют намерение текста пользователя с намерением LUIS.

На странице Намерения для HomeAutomation.AddDeviceAlias введите следующие примеры речевых фрагментов в разделе Пример речевого фрагмента:

Для получения наилучших результатов примеры речевых фрагментов должны различаться по следующим параметрам:

• длина речевого фрагмента;
• пунктуация;
• выбор слов;
• время глагола (есть, было, будет);
• порядок слов.

Добавление меток к примеру речевого фрагмента

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

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

Добавление меток на палитре сущностей

При выборе значка @ в правом верхнем углу откроется палитра сущностей в правой части страницы.

1. Выберите сущность, к которой нужно добавить метки.

   

2. Выделите текст, которым нужно пометить эту сущность.

   

Встроенные метки

1. Выделите текст, который нужно применить в качестве метки.

2. В появившемся меню выберите сущность, которую нужно пометить текстом.

   

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

На этом этапе разработка приложения завершена. Вам необходимо создать ресурс для прогнозирования, чтобы опубликовать приложение и начать получать прогнозы в чат-боте или других клиентских приложениях через конечную точку прогнозирования.

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

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

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

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

   

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

   

Публикация приложения для получения URL-адреса конечной точки

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

1. Выберите Опубликовать на правой верхней панели навигации.

   

2. Выберите слот Рабочий и нажмите кнопку Готово.

   

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

   

Запрос конечной точки прогнозирования API V3

1. На портале LUIS в разделе Управление (в верхнем правом меню) на странице Ресурсы Azure (меню слева) на вкладке Ресурсы прогнозирования скопируйте пример запроса в нижней части страницы. URL-адрес содержит идентификатор приложения, ключ и имя слота. URL-адрес конечной точки прогнозирования V3 выглядит следующим образом: https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE

   

   Вставьте URL-адрес на новую вкладку браузера. Если URL-адрес не отображается, у вас нет ресурса прогнозирования и потребуется создать его.

2. В адресной строке браузера для строки запроса проверьте, указаны ли в URL-адресе приведенные ниже значения. Если они отсутствуют в строке запроса, добавьте их:

   • verbose=true
   • show-all-intents=true

3. В адресной строке браузера перейдите в конец URL-адреса и введите turn off the living room light (выключить свет в гостиной) в качестве строки запроса, после чего нажмите клавишу ВВОД.

   {
       "query": "turn off the living room light",
       "prediction": {
           "topIntent": "HomeAutomation.TurnOff",
           "intents": {
               "HomeAutomation.TurnOff": {
                   "score": 0.969448864
               },
               "HomeAutomation.QueryState": {
                   "score": 0.0122336326
               },
               "HomeAutomation.TurnUp": {
                   "score": 0.006547436
               },
               "HomeAutomation.TurnDown": {
                   "score": 0.0050634006
               },
               "HomeAutomation.SetDevice": {
                   "score": 0.004951761
               },
               "HomeAutomation.TurnOn": {
                   "score": 0.00312553928
               },
               "None": {
                   "score": 0.000552945654
               }
           },
           "entities": {
               "HomeAutomation.Location": [
                   "living room"
               ],
               "HomeAutomation.DeviceName": [
                   [
                       "living room light"
                   ]
               ],
               "HomeAutomation.DeviceType": [
                   [
                       "light"
                   ]
               ],
               "$instance": {
                   "HomeAutomation.Location": [
                       {
                           "type": "HomeAutomation.Location",
                           "text": "living room",
                           "startIndex": 13,
                           "length": 11,
                           "score": 0.902181149,
                           "modelTypeId": 1,
                           "modelType": "Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ],
                   "HomeAutomation.DeviceName": [
                       {
                           "type": "HomeAutomation.DeviceName",
                           "text": "living room light",
                           "startIndex": 13,
                           "length": 17,
                           "modelTypeId": 5,
                           "modelType": "List Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ],
                   "HomeAutomation.DeviceType": [
                       {
                           "type": "HomeAutomation.DeviceType",
                           "text": "light",
                           "startIndex": 25,
                           "length": 5,
                           "modelTypeId": 5,
                           "modelType": "List Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ]
               }
           }
       }
   }
   

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

Удалите приложение LUIS, если оно больше не нужно. Для этого выберите Мои приложения в меню слева вверху. Щелкните многоточие (...) справа от имени приложения в списке и выберите пункт Удалить. Во всплывающем диалоговом окне Delete app? (Удалить приложение?) нажмите кнопку ОК.

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

• Итеративный дизайн приложения
• Рекомендации