Compartir a través de

class Intent::IntentRecognizer

  • Artículo
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

Además de realizar el reconocimiento de voz a texto, IntentRecognizer extrae información estructurada sobre la intención del hablante, que se puede usar para impulsar otras acciones mediante desencadenadores de intención dedicados (consulte IntentTrigger).

Miembros

Propiedades

Sintaxis: public PropertyCollection & Properties;

Colección de propiedades y sus valores definidos para este IntentRecognizer.

IntentRecognizer

Sintaxis: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Constructor interno. Crea una nueva instancia mediante el identificador proporcionado.

Parámetros

  • hreco controlador recognizer.

~IntentRecognizer

Sintaxis: public inline ~IntentRecognizer ( );

destructor

RecognizeOnceAsync

Sintaxis: public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

Inicia el reconocimiento de intenciones y devuelve después de que se reconozca una sola expresión. El final de una sola expresión se determina escuchando silencio al final o hasta que se procesa un máximo de unos 30 segundos de audio. La tarea devuelve el texto de reconocimiento como resultado. Nota: Dado que RecognizeOnceAsync() solo devuelve una sola expresión, solo es adecuado para el reconocimiento de captura única como comando o consulta. Para el reconocimiento de varias expresiones de larga duración, use StartContinuousRecognitionAsync() en su lugar.

Devuelve

Futuro que contiene el valor de resultado (un puntero compartido a IntentRecognitionResult) del reconocimiento de intenciones asincrónicas.

RecognizeOnceAsync

Sintaxis: public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

Inicia el reconocimiento de intenciones y genera un resultado del texto pasado. Esto resulta útil para realizar pruebas y otras veces cuando la entrada de voz no está vinculada a IntentRecognizer. Nota: El servicio de intención no admite actualmente esto, por lo que solo es válido para la coincidencia de patrones sin conexión o las intenciones de coincidencia exactas.

Parámetros

  • text Texto que se va a evaluar.

Devuelve

Futuro que contiene el valor de resultado (un puntero compartido a IntentRecognitionResult) del reconocimiento de intenciones asincrónicas.

StartContinuousRecognitionAsync

Sintaxis: public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

Inicia de forma asincrónica la operación de reconocimiento continuo de intenciones.

Devuelve

Un futuro vacío.

StopContinuousRecognitionAsync

Sintaxis: public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

Finaliza de forma asincrónica la operación de reconocimiento continuo de intenciones.

Devuelve

Un futuro vacío.

StartKeywordRecognitionAsync

Sintaxis: public inline virtual std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Inicia de forma asincrónica la operación de reconocimiento de palabras clave.

Parámetros

  • model Especifica el modelo de palabras clave que se va a usar.

Devuelve

Un futuro vacío.

StopKeywordRecognitionAsync

Sintaxis: public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

Finaliza de forma asincrónica la operación de reconocimiento de palabras clave.

Devuelve

Un futuro vacío.

AddIntent

Sintaxis: public inline void AddIntent ( const std::string & simplePhrase );

Agrega una frase simple que el usuario puede hablar, lo que indica una intención de usuario específica. Esta frase simple puede ser un patrón que incluye y enitidad rodeado de llaves. Por ejemplo, "haga clic en la casilla {checkboxName} ".

Parámetros

  • simplePhrase La frase correspondiente a la intención.

Una vez reconocido, la propiedad IntentId de IntentRecognitionResult coincidirá con la simplePhrase especificada aquí. Si se especifican y coinciden entidades, estarán disponibles en la llamada IntentResult->GetEntities().

AddIntent

Sintaxis: public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

Agrega una frase simple que el usuario puede hablar, lo que indica una intención de usuario específica. Esta frase simple puede ser un patrón que incluye y enitidad rodeado de llaves. Por ejemplo, "haga clic en la casilla {checkboxName} ".

Parámetros

  • simplePhrase La frase correspondiente a la intención.

  • intentId una cadena de identificador personalizada que se va a devolver en la propiedad IntentRecognitionResult de IntentId.

Una vez reconocido, el identificador de intención del resultado coincidirá con el identificador proporcionado aquí. Si se especifican y coinciden entidades, estarán disponibles en la llamada IntentResult->GetEntities().

AddIntent

Sintaxis: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );

Agrega una única intención por nombre del modelo de Language Understanding especificado. Para los tipos PatternMatchingModel y ConversationalLanguageUnderstandingModel, se borrarán los modelos existentes antes de habilitarlo. Para estos tipos, se omite intentName.

Parámetros

  • model El modelo de Language Understanding que contiene la intención.

  • intentName Nombre de la única intención que se va a incluir en el modelo de Language Understanding.

Una vez reconocido, la propiedad IntentId de IntentRecognitionResult contendrá el valor intentName especificado aquí.

AddIntent

Sintaxis: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName , const std::string & intentId );

Agrega una única intención por nombre del modelo de Language Understanding especificado. Para los tipos PatternMatchingModel y ConversationalLanguageUnderstandingModel, se borrarán los modelos existentes antes de habilitarlo. Para estos tipos, se omiten intentName e intentId.

Parámetros

  • model El modelo de Language Understanding que contiene la intención.

  • intentName Nombre de la única intención que se va a incluir en el modelo de Language Understanding.

  • intentId una cadena de identificador personalizada que se va a devolver en la propiedad IntentRecognitionResult de IntentId.

AddAllIntents

Sintaxis: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

Agrega todas las intenciones del modelo de Language Understanding especificado. Para los tipos PatternMatchingModel y ConversationalLanguageUnderstandingModel, se borrarán los modelos existentes antes de habilitarlo.

Parámetros

  • model El modelo de Language Understanding que contiene las intenciones.

Una vez reconocido, la propiedad IntentId de IntentRecognitionResult contendrá el nombre de la intención reconocida.

AddAllIntents

Sintaxis: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentId );

Agrega todas las intenciones del modelo de Language Understanding especificado. Para los tipos PatternMatchingModel y ConversationalLanguageUnderstandingModel, se borrarán los modelos existentes antes de habilitarlo.

Parámetros

  • model El modelo de Language Understanding que contiene las intenciones.

  • intentId Un identificador de cadena personalizado que se va a devolver en la propiedad IntentRecognitionResult.

AddIntent

Sintaxis: public inline void AddIntent ( std::shared_ptr< IntentTrigger > trigger , const std::string & intentId );

Agrega el objeto IntentTrigger especificado.

Parámetros

  • trigger IntentTrigger correspondiente a la intención.

  • intentId Un identificador de cadena personalizado que se va a devolver en la propiedad IntentRecognitionResult.

SetAuthorizationToken

Sintaxis: public inline void SetAuthorizationToken ( const std::string & token );

Establece el token de autorización que se usará para conectarse al servicio. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo llamando a este establecedor con un nuevo token válido. De lo contrario, el reconocedor encontrará errores durante el reconocimiento.

Parámetros

  • token Cadena que representa el token de autorización.

GetAuthorizationToken

Sintaxis: public inline std::string GetAuthorizationToken ( );

Obtiene el token de autorización.

Devuelve

Token de autorización

ApplyLanguageModels

Sintaxis: public inline bool ApplyLanguageModels ( const std::vector< std::shared_ptr< LanguageUnderstandingModel > > & collection );

Toma una colección de modelos de Language Understanding, realiza una copia de ellos y los aplica al reconocedor. Esta aplicación se produce en momentos diferentes en función del tipo de modelo de Language Understanding. Los modelos de lenguaje simple se activarán casi inmediatamente, mientras que los modelos de Language Understanding que usan LUIS se activarán en el siguiente turno de voz. Esto reemplaza los modelos aplicados anteriormente.

Parámetros

  • collection vector de punteros compartidos a LanguageUnderstandingModels.

Devuelve

True si la aplicación de los modelos surte efecto inmediatamente. De lo contrario, false.

FromConfig

Sintaxis: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< SpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Crea un reconocedor de intenciones a partir de una configuración de voz y una configuración de audio. Los usuarios deben usar esta función para crear una nueva instancia de un reconocedor de intenciones.

Parámetros

  • speechConfig configuración de Voz.

  • audioInput configuración de audio.

Devuelve

Instancia del reconocedor de intenciones.

FromConfig

Sintaxis: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Crea un reconocedor de intenciones a partir de una configuración de voz incrustada y una configuración de audio. Los usuarios deben usar esta función para crear una nueva instancia de un reconocedor de intenciones. Se agregó en la versión 1.19.0.

Parámetros

  • speechConfig configuración de voz insertada.

  • audioInput configuración de audio.

Devuelve

Instancia del reconocedor de intenciones.

BaseType

Sintaxis: typedef BaseType;