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

class Intent::IntentRecognizer

  • Статья
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

Помимо распознавания речи в текст, НамерениеRecognizer извлекает структурированную информацию о намерении говорящего, которая может использоваться для выполнения дальнейших действий с помощью триггеров выделенных намерений (см. IntentTrigger).

Члены

Свойства

Синтаксис: public PropertyCollection & Properties;

Коллекция свойств и их значений, определенных для этого объекта IntentRecognizer.

IntentRecognizer

Синтаксис: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Внутренний конструктор. Создает новый экземпляр с помощью предоставленного дескриптора.

Параметры

  • дескриптор распознавателя hreco.

~IntentRecognizer

Синтаксис: public inline ~IntentRecognizer ( );

мусоросжигательная печь

RecognizeOnceAsync

Синтаксис: public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

Запускает распознавание намерений и возвращается после распознавания одного высказывания. Конец одного высказывания определяется прослушиванием тишины в конце или до тех пор, пока не будет обработано не более 30 секунд звука. Задача возвращает текст распознавания в результате. Примечание. Так как RecognizeOnceAsync() возвращает только одно высказывание, оно подходит только для распознавания одного снимка, например команды или запроса. Для длительного многофакторного распознавания речи используйте StartContinuousRecognitionAsync().

Возвращает

Будущее, содержащее значение результата (общий указатель на IntentRecognitionResult) асинхронного распознавания намерений.

RecognizeOnceAsync

Синтаксис: public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

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

Параметры

  • text вычисляемого текста.

Возвращает

Будущее, содержащее значение результата (общий указатель на IntentRecognitionResult) асинхронного распознавания намерений.

StartContinuousRecognitionAsync

Синтаксис: public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

Асинхронно инициирует операцию непрерывного распознавания намерений.

Возвращает

Пустое будущее.

StopContinuousRecognitionAsync

Синтаксис: public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

Асинхронно завершает непрерывную операцию распознавания намерений.

Возвращает

Пустое будущее.

StartKeywordRecognitionAsync

Синтаксис: public inline virtual std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Асинхронно инициирует операцию распознавания ключевых слов.

Параметры

  • model Указывает используемую модель ключевых слов.

Возвращает

Пустое будущее.

StopKeywordRecognitionAsync

Синтаксис: public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

Асинхронно завершает операцию распознавания ключевых слов.

Возвращает

Пустое будущее.

AddIntent

Синтаксис: public inline void AddIntent ( const std::string & simplePhrase );

Добавляет простую фразу, которая может быть произнесено пользователем, указывая определенное намерение пользователя. Эта простая фраза может быть шаблоном, включая и заманчивость, окруженную фигурными скобками. Например, установите флажок {checkboxName}.

Параметры

  • simplePhrase Фраза, соответствующая намерению.

После распознавания свойство IntentRecognitionResultResult будет соответствовать простой фразе, указанной здесь. Если какие-либо сущности указаны и сопоставлены, они будут доступны в вызове IntentResult->GetEntities().

AddIntent

Синтаксис: public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

Добавляет простую фразу, которая может быть произнесено пользователем, указывая определенное намерение пользователя. Эта простая фраза может быть шаблоном, включая и заманчивость, окруженную фигурными скобками. Например, установите флажок {checkboxName}.

Параметры

  • simplePhrase Фраза, соответствующая намерению.

  • intentId строку пользовательского идентификатора, возвращаемую в свойстве IntentRecognitionResult в IntentId.

После распознавания идентификатор намерения результата будет соответствовать указанному здесь идентификатору. Если какие-либо сущности указаны и сопоставлены, они будут доступны в вызове IntentResult->GetEntities().

AddIntent

Синтаксис: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );

Добавляет одно намерение по имени из указанной модели распознавания речи. Для типов PatternMatchingModel и ConversationalLanguageUnderstandingModel это позволит очистить все существующие модели перед включением. Для этих типов имя намерения игнорируется.

Параметры

  • model Модель распознавания речи, содержащая намерение.

  • intentName Имя единого намерения, включаемого из модели распознавания речи.

После распознавания свойство IntentRecognitionResultResult будет содержать имя намерения, указанное здесь.

AddIntent

Синтаксис: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName , const std::string & intentId );

Добавляет одно намерение по имени из указанной модели распознавания речи. Для типов PatternMatchingModel и ConversationalLanguageUnderstandingModel это позволит очистить все существующие модели перед включением. Для этих типов не учитывается имя намерения и идентификатор намерения.

Параметры

  • model Модель распознавания речи, содержащая намерение.

  • intentName Имя единого намерения, включаемого из модели распознавания речи.

  • intentId строку пользовательского идентификатора, возвращаемую в свойстве IntentRecognitionResult в IntentId.

AddAllIntents

Синтаксис: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

Добавляет все намерения из указанной модели распознавания речи. Для типов PatternMatchingModel и ConversationalLanguageUnderstandingModel это позволит очистить все существующие модели перед включением.

Параметры

  • model модель распознавания речи, содержащая намерения.

После распознавания свойство IntentRecognitionResultResult будет содержать имя распознанного намерения.

AddAllIntents

Синтаксис: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentId );

Добавляет все намерения из указанной модели распознавания речи. Для типов PatternMatchingModel и ConversationalLanguageUnderstandingModel это позволит очистить все существующие модели перед включением.

Параметры

  • model модель распознавания речи, содержащая намерения.

  • intentId Пользовательский идентификатор строки, возвращаемый в свойстве IntentRecognitionResult в IntentId.

AddIntent

Синтаксис: public inline void AddIntent ( std::shared_ptr< IntentTrigger > trigger , const std::string & intentId );

Добавляет указанный объект IntentTrigger.

Параметры

  • trigger Объект IntentTrigger, соответствующий намерению.

  • intentId Пользовательский идентификатор строки, возвращаемый в свойстве IntentRecognitionResult в IntentId.

SetAuthorizationToken

Синтаксис: public inline void SetAuthorizationToken ( const std::string & token );

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

Параметры

  • token строка, представляющая маркер авторизации.

GetAuthorizationToken

Синтаксис: public inline std::string GetAuthorizationToken ( );

Возвращает маркер авторизации.

Возвращает

Маркер авторизации

ApplyLanguageModels

Синтаксис: public inline bool ApplyLanguageModels ( const std::vector< std::shared_ptr< LanguageUnderstandingModel > > & collection );

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

Параметры

  • collection Вектор общих указателей на LanguageUnderstandingModels.

Возвращает

Значение true, если приложение моделей вступает в силу немедленно. В противном случае значение false.

FromConfig

Синтаксис: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< SpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Создает распознаватель намерений из конфигурации речи и звуковой конфигурации. Пользователи должны использовать эту функцию для создания нового экземпляра распознавателя намерений.

Параметры

  • speechConfig конфигурации службы "Речь".

  • audioInput конфигурации звука.

Возвращает

Экземпляр распознавателя намерений.

FromConfig

Синтаксис: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Создает распознаватель намерений из встроенной конфигурации речи и звуковой конфигурации. Пользователи должны использовать эту функцию для создания нового экземпляра распознавателя намерений. Добавлено в версию 1.19.0.

Параметры

  • speechConfig Встроенная конфигурация речи.

  • audioInput конфигурации звука.

Возвращает

Экземпляр распознавателя намерений.

BaseType

Синтаксис: typedef BaseType;