Partilhar via

intenção da classe::IntentRecognizer

  • Artigo
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

Além de realizar o reconhecimento de fala para texto, o IntentRecognizer extrai informações estruturadas sobre a intenção do orador, que podem ser usadas para conduzir outras ações usando gatilhos de intenção dedicados (consulte IntentTrigger).

Membros

Propriedades

Sintaxe: public PropertyCollection & Properties;

Uma coleção de propriedades e seus valores definidos para este IntentRecognizer.

IntentRecognizer

Sintaxe: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Construtor interno. Cria uma nova instância usando o identificador fornecido.

Parâmetros

  • hreco Alça do reconhecedor.

~IntentRecognizer

Sintaxe: public inline ~IntentRecognizer ( );

destruidor

RecognizeOnceAsync

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

Inicia o reconhecimento de intenção e retorna depois que um único enunciado é reconhecido. O fim de um único enunciado é determinado pela escuta do silêncio no final ou até que um máximo de cerca de 30 segundos de áudio seja processado. A tarefa retorna o texto de reconhecimento como resultado. Nota: Como RecognizeOnceAsync() retorna apenas um único enunciado, ele é adequado apenas para reconhecimento de disparo único, como comando ou consulta. Para reconhecimento de vários enunciados de longa duração, use StartContinuousRecognitionAsync() em vez disso..

Devoluções

Futuro contendo valor de resultado (um ponteiro compartilhado para IntentRecognitionResult) do reconhecimento de intenção assíncrono.

RecognizeOnceAsync

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

Inicia o reconhecimento de intenção e gera um resultado do texto passado. Isso é útil para testes e outras vezes em que a entrada de fala não está vinculada ao IntentRecognizer. Nota: Atualmente, o Serviço de Intenção não oferece suporte a isso, portanto, só é válido para correspondência de padrão offline ou intenções de correspondência exata.

Parâmetros

  • text O texto a avaliar.

Devoluções

Futuro contendo valor de resultado (um ponteiro compartilhado para IntentRecognitionResult) do reconhecimento de intenção assíncrono.

StartContinuousRecognitionAsync

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

Inicia de forma assíncrona a operação de reconhecimento contínuo de intenção.

Devoluções

Um futuro vazio.

StopContinuousRecognitionAsync

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

Encerra de forma assíncrona a operação contínua de reconhecimento de intenção contínua.

Devoluções

Um futuro vazio.

StartKeywordRecognitionAsync

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

Inicia de forma assíncrona a operação de reconhecimento de palavras-chave.

Parâmetros

  • model Especifica o modelo de palavra-chave a ser usado.

Devoluções

Um futuro vazio.

StopKeywordRecognitionAsync

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

Encerra de forma assíncrona a operação de reconhecimento de palavras-chave.

Devoluções

Um futuro vazio.

AddIntent

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

Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção específica do usuário. Esta frase simples pode ser um padrão incluindo e enitity cercado por chaves. Como "clique na caixa de seleção {checkboxName}".

Parâmetros

  • simplePhrase A frase correspondente à intenção.

Uma vez reconhecida, a propriedade IntentRecognitionResult do IntentRecognitionResult corresponderá à simplePhrase especificada aqui. Se quaisquer entidades forem especificadas e correspondidas, elas estarão disponíveis na chamada IntentResult->GetEntities().

AddIntent

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

Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção específica do usuário. Esta frase simples pode ser um padrão incluindo e enitity cercado por chaves. Como "clique na caixa de seleção {checkboxName}".

Parâmetros

  • simplePhrase A frase correspondente à intenção.

  • intentId Uma cadeia de caracteres de id personalizada a ser retornada na propriedade IntentRecognitionResult do IntentRecognitionResult.

Uma vez reconhecido, o id de intenção do resultado corresponderá ao id fornecido aqui. Se quaisquer entidades forem especificadas e correspondidas, elas estarão disponíveis na chamada IntentResult->GetEntities().

AddIntent

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

Adiciona uma única intenção por nome do Modelo de Compreensão de Linguagem especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de ativá-lo. Para esses tipos, o intentName é ignorado.

Parâmetros

  • model O modelo de compreensão da linguagem que contém a intenção.

  • intentName O nome da intenção única a ser incluída no modelo de compreensão de linguagem.

Uma vez reconhecida, a propriedade IntentRecognitionResult do IntentRecognitionResult conterá o intentName especificado aqui.

AddIntent

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

Adiciona uma única intenção por nome do Modelo de Compreensão de Linguagem especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de ativá-lo. Para esses tipos, o intentName e o intentId são ignorados.

Parâmetros

  • model O modelo de compreensão da linguagem que contém a intenção.

  • intentName O nome da intenção única a ser incluída no modelo de compreensão de linguagem.

  • intentId Uma cadeia de caracteres de id personalizada a ser retornada na propriedade IntentRecognitionResult do IntentRecognitionResult.

AddAllIntents

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

Adiciona todas as intenções do Modelo de Compreensão de Linguagem especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de ativá-lo.

Parâmetros

  • model O modelo de compreensão da linguagem que contém as intenções.

Uma vez reconhecida, a propriedade IntentRecognitionResult do IntentResult conterá o nome da intenção reconhecida.

AddAllIntents

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

Adiciona todas as intenções do Modelo de Compreensão de Linguagem especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de ativá-lo.

Parâmetros

  • model O modelo de compreensão da linguagem que contém as intenções.

  • intentId Uma id de cadeia de caracteres personalizada a ser retornada na propriedade IntentRecognitionResult do IntentResult.

AddIntent

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

Adiciona o IntentTrigger especificado.

Parâmetros

  • trigger O IntentTrigger correspondente à intenção.

  • intentId Uma id de cadeia de caracteres personalizada a ser retornada na propriedade IntentRecognitionResult do IntentResult.

SetAuthorizationToken

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

Define o token de autorização que será usado para se conectar ao serviço. Nota: O chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo chamando esse setter com um novo token válido. Caso contrário, o reconhecedor encontrará erros durante o reconhecimento.

Parâmetros

  • token Uma cadeia de caracteres que representa o token de autorização.

GetAuthorizationToken

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

Obtém o token de autorização.

Devoluções

Token de autorização

ApplyLanguageModels

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

Pega uma coleção de modelos de compreensão de linguagem, faz uma cópia deles e aplica-os ao reconhecedor. Esta aplicação acontece em momentos diferentes, dependendo do tipo de modelo de compreensão de linguagem. Os Modelos de Linguagem Simples tornar-se-ão ativos quase imediatamente, enquanto os modelos de compreensão de linguagem que utilizam o LUIS tornar-se-ão ativos na próxima Curva de Fala. Isso substitui todos os modelos aplicados anteriormente.

Parâmetros

  • collection Um vetor de ponteiros compartilhados para LanguageUnderstandingModels.

Devoluções

Verdade se a aplicação dos modelos entrar em vigor imediatamente. Caso contrário, falso.

FromConfig

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

Cria um reconhecedor de intenção a partir de uma configuração de fala e uma configuração de áudio. Os usuários devem usar essa função para criar uma nova instância de um reconhecedor de intenção.

Parâmetros

  • speechConfig Configuração de fala.

  • audioInput Configuração de áudio.

Devoluções

Instância de reconhecimento de intenção.

FromConfig

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

Cria um reconhecedor de intenção a partir de uma configuração de fala incorporada e uma configuração de áudio. Os usuários devem usar essa função para criar uma nova instância de um reconhecedor de intenção. Adicionado na versão 1.19.0.

Parâmetros

  • speechConfig Configuração de fala incorporada.

  • audioInput Configuração de áudio.

Devoluções

Instância de reconhecimento de intenção.

Tipo Base

Sintaxe: typedef BaseType;