Compartilhar via

classe Intent::IntentRecognizer

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

Além de executar o reconhecimento de fala em texto, o IntentRecognizer extrai informações estruturadas sobre a intenção do alto-falante, 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

  • identificador hreco 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 final de um único enunciado é determinado ouvindo o 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. Observação: como RecognizeOnceAsync() retorna apenas um único enunciado, ele é adequado apenas para o reconhecimento de tiro único, como comando ou consulta. Para reconhecimento de vários enunciados de execução longa, use StartContinuousRecognitionAsync() em vez disso..

Retorna

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

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. Observação: atualmente, o Serviço de Intenção não dá suporte a isso, portanto, ele só é válido para correspondência de padrões offline ou intenções exatas de correspondência.

Parâmetros

  • text o texto a ser avaliado.

Retorna

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

StartContinuousRecognitionAsync

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

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

Retorna

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.

Retorna

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 palavra-chave.

Parâmetros

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

Retorna

Um futuro vazio.

StopKeywordRecognitionAsync

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

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

Retorna

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 de usuário específica. Essa frase simples pode ser um padrão, incluindo enitidade cercada por chaves. Como "clique na caixa de seleção {checkboxName}".

Parâmetros

  • simplePhrase a frase correspondente à intenção.

Uma vez reconhecida, a propriedade IntentId de IntentRecognitionResult corresponderá ao simplePhrase especificado aqui. Se alguma entidade for especificada e correspondida, 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 de usuário específica. Essa frase simples pode ser um padrão, incluindo enitidade cercada 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 IntentId de IntentRecognitionResult.

Uma vez reconhecida, a ID de intenção do resultado corresponderá à ID fornecida aqui. Se alguma entidade for especificada e correspondida, 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 reconhecimento vocal especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de habilitá-lo. Para esses tipos, o intentName é ignorado.

Parâmetros

  • model o modelo de reconhecimento vocal que contém a intenção.

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

Uma vez reconhecida, a propriedade IntentId de 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 reconhecimento vocal especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de habilitá-lo. Para esses tipos, o intentName e intentId são ignorados.

Parâmetros

  • model o modelo de reconhecimento vocal que contém a intenção.

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

  • intentId uma cadeia de caracteres de ID personalizada a ser retornada na propriedade IntentId de IntentRecognitionResult.

AddAllIntents

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

Adiciona todas as intenções do modelo de reconhecimento vocal especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de habilitá-lo.

Parâmetros

  • model O modelo de reconhecimento vocal que contém as intenções.

Uma vez reconhecida, a propriedade IntentId de IntentRecognitionResult 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 reconhecimento vocal especificado. Para os tipos PatternMatchingModel e ConversationalLanguageUnderstandingModel, isso limpará todos os modelos existentes antes de habilitá-lo.

Parâmetros

  • model O modelo de reconhecimento vocal que contém as intenções.

  • intentId uma ID de cadeia de caracteres personalizada a ser retornada na propriedade IntentId de IntentRecognitionResult.

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 IntentId de IntentRecognitionResult.

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. Observação: 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.

Retorna

Token de autorização

ApplyLanguageModels

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

Usa uma coleção de modelos de reconhecimento vocal, faz uma cópia deles e os aplica ao reconhecedor. Esse aplicativo ocorre em momentos diferentes, dependendo do tipo de modelo de reconhecimento vocal. Os Modelos de Linguagem Simples se tornarão ativos quase imediatamente, enquanto os modelos de reconhecimento de linguagem que utilizam o LUIS se tornarã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.

Retorna

True se a aplicação dos modelos entra em vigor imediatamente. Caso contrário, false.

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 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 a configuração de Fala.

  • audioInput Configuração de áudio.

Retorna

Instância do reconhecedor 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 inserida e de 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 inserida.

  • audioInput Configuração de áudio.

Retorna

Instância do reconhecedor de intenção.

BaseType

Sintaxe: typedef BaseType;