Ресурсы для разработчиков (пакет SDK, REST и CLI для Распознавания речи (LUIS))

  • Статья

Внимание

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

Пакеты SDK, интерфейсы REST API, CLI помогают разрабатывать приложения Распознавания речи (LUIS) на вашем языке. Вы можете управлять ресурсами Azure и прогнозами LUIS.

Управление ресурсами Azure

Используйте уровень управления службами искусственного интеллекта Azure для создания, редактирования, перечисления и удаления ресурса Распознавание речи или служб ИИ Azure.

Справочная документация в зависимости от средства:

Разработка Распознавания речи и запросы прогнозирования

Доступ к службе "Распознавание речи" осуществляется из ресурса Azure, который необходимо создать. Есть два ресурса:

  • Используйте ресурс разработки для обучения созданию, изменению, обучению и публикации.
  • Используйте прогнозирование для среды выполнения, чтобы отправлять текст пользователя и получать прогноз.

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

Спецификации REST

Спецификации LUIS REST, а также все спецификации Azure REST доступны в GitHub.

Интерфейсы REST API

API-интерфейсы для конечных точек разработки и прогнозирования доступны в интерфейсах REST API:

Тип Версия
Разработка Версия 2
Предварительная версия 3
Прогноз Версия 2
Версия 3

Конечные точки REST

Сейчас в LUIS есть 2 типа конечных точек:

  • разработка в конечной точке обучения;
  • запрос прогнозирования в конечной точке среды выполнения.
Назначение URL
Версия 2, разработка для конечной точки обучения https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Версия 3, разработка для конечной точки обучения https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Версия 2, прогнозирование — все прогнозы для конечной точки среды выполнения https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Версия 3, прогнозирование — прогноз для версий для конечной точки среды выполнения https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Версия 3, прогнозирование — прогноз для слотов для конечной точки среды выполнения https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

В следующей таблице описаны параметры, обозначенные фигурными скобками {} в предыдущей таблице.

Параметр Характер использования
your-resource-name Имя ресурса Azure
q или query Текст фразы, отправляемый из клиентского приложения, такого как чат-бот
version Имя версии с 10 символами
slot production или staging

Параметры строки запроса REST

Ниже представлены некоторые параметры строки запроса API версии 3.

Параметр запроса Имя портала LUIS Тип Версия По умолчанию. Характер использования
log Сохранять журналы boolean Версия 2 и версия 3 false Сохранение запроса в файле журнала. По умолчанию используется значение false.
query - строка Только версия 3 Значение по умолчанию отсутствует — оно является обязательным только в запросе GET. В версии 2 прогнозируемый речевой фрагмент находится в параметре q.

В версии 3 функциональность передается в параметре query.
show-all-intents Включить оценки для всех намерений boolean Только версия 3 false Возврат всех намерений с соответствующей оценкой в объекте prediction.intents. Намерения возвращаются в виде объектов в родительском объекте intents. Эта команда обеспечивает программный доступ без необходимости находить намерение в массиве: prediction.intents.give. В версии 2 они возвращались в массиве.
verbose Включить больше сведений об объектах boolean Версия 2 и версия 3 false В версии 2 возвращались все прогнозируемые намерения, если было задано значение true. Если требуются все прогнозируемые намерения, используйте параметр show-all-intents версии 3.

В версии 3 этот параметр предоставляет только сведения о метаданных сущности прогнозирования сущностей.
timezoneOffset - строка V2 - Часовой пояс, применяемый к сущностям datetimeV2.
datetimeReference - строка V3 - Часовой пояс, применяемый к сущностям datetimeV2. Заменяет timezoneOffset из версии 2.

Схема приложения

Схема приложения импортируется и экспортируется в формате .json или .lu.

Пакеты SDK на основе языка

Язык Справочная документация Пакет Краткие руководства
C# Создание
Прогнозирование		 Разработка NuGet
Прогнозирование NuGet		 Разработка
Прогнозирование запросов
Go Разработка и прогнозирование SDK
Java Разработка и прогнозирование Разработка Maven
Прогноз Maven
JavaScript Разработка
Прогноз		 Разработка NPM
Прогноз NPM		 Разработка
Прогноз
Python Разработка и прогнозирование Pip Разработка
Прогноз

Контейнеры

Распознавание речи (LUIS) предоставляет контейнер для локальных и автономных версий приложения.

Форматы экспорта и импорта

Распознавание речи предоставляет возможность управлять приложением и его моделями в формате JSON, формате .LU (LUDown) и с помощью сжатого пакета для контейнера Распознавания речи.

Импорт и экспорт этих форматов можно выполнить из API-интерфейсов и портала LUIS. Портал позволяет выполнить импорт и экспорт как часть списка приложений и версий.

Семинары

средства непрерывной интеграции;

Средства Bot Framework

Платформа бота доступна в виде пакета SDK на различных языках и в качестве службы с помощью Azure AI Служба Bot.

Bot Framework предоставляет несколько средств, помогающих при распознавании речи, в том числе указанные ниже средства.

  • Классическое приложение Bot Framework Emulator позволяет разработчикам ботов выполнять тестирование и отладку ботов, созданных с помощью пакета SDK для Bot Framework.
  • Bot Framework Composer — это интегрированный инструмент для разработчиков и междисциплинарных команд, предназначенный для разработки ботов и средств для общения на платформе Microsoft Bot Framework.
  • Примеры для Bot Framework — в #C, JavaScript, TypeScript и Python.

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