IntentRecognizer Classe

Além de executar o reconhecimento de fala em texto, o IntentRecognizer extrai informações estruturadas sobre a intenção do locutor.

Herança

Recognizer

IntentRecognizer

Construtor

IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)

Parâmetros

Nome	Description
speech_config Obrigatório	A configuração para o reconhecedor de fala.
audio_config	A configuração para a entrada de áudio. valor padrão: None
intents	Intenções de um iterável sobre pares de (modelo, intent_id) ou (simple_phrase, intent_id) a serem reconhecidos. valor padrão: None

Métodos

add_all_intents	Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.
add_intent	Adicione uma intenção ao reconhecedor. Há diferentes maneiras de fazer isso: add_intent(simple_phrase): adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica. add_intent(simple_phrase, intent_id): adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica. Depois de reconhecida, a ID de intenção do resultado corresponderá à ID fornecida aqui. add_intent(model, intent_name): adiciona uma única intenção por nome do especificado LanguageUnderstandingModel. add_intent(model, intent_name, intent_id): adiciona uma única intenção por nome do especificado LanguageUnderstandingModel. add_intent(gatilho, intent_id): adiciona o IntentTrigger especificado. IntentTrigger.
add_intents	Adicione intenções de um iterável sobre pares de (modelo, intent_id) ou (simple_phrase, intent_id).
recognize_once	Executa o reconhecimento em um modo de bloqueio (síncrono). É retornado depois que um único enunciado é reconhecido. O fim de um único enunciado é determinado pela escuta de silêncio no fim ou até o máximo de 15 segundos de áudio processado. A tarefa retorna o texto de reconhecimento como resultado. Para reconhecimento de múltiplas expressões de longa duração, use start_continuous_recognition_async.
recognize_once_async	Executa o reconhecimento em um modo não bloqueado (assíncrono). Reconhecerá um único enunciado. O fim de um único enunciado é determinado pela escuta de silêncio no fim ou até o máximo de 15 segundos de áudio processado. Para reconhecimento de múltiplas expressões de longa duração, use start_continuous_recognition_async.
start_continuous_recognition	Inicia de forma síncrona a operação de reconhecimento contínuo. O usuário precisa se conectar a EventSignal para receber os resultados de reconhecimento. Chame stop_continuous_recognition_async para interromper o reconhecimento.
start_continuous_recognition_async	Inicia de forma assíncrona a operação de reconhecimento contínuo. O usuário precisa se conectar a EventSignal para receber os resultados de reconhecimento. Chame stop_continuous_recognition_async para interromper o reconhecimento.
start_keyword_recognition	Configura de forma síncrona o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition() para encerrar o reconhecimento iniciado por palavra-chave.
start_keyword_recognition_async	Configura de forma assíncrona o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition_async() para encerrar o reconhecimento iniciado por palavra-chave.
stop_continuous_recognition	Encerra de forma síncrona a operação de reconhecimento contínuo contínua.
stop_continuous_recognition_async	Encerra de forma assíncrona a operação de reconhecimento contínuo contínua.
stop_keyword_recognition	Termina de forma síncrona o reconhecimento iniciado por palavra-chave.
stop_keyword_recognition_async	Termina de forma assíncrona o reconhecimento iniciado por palavra-chave.

add_all_intents

Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.

add_all_intents(model: LanguageUnderstandingModel)

Parâmetros

Nome	Description
model Obrigatório

add_intent

Adicione uma intenção ao reconhecedor. Há diferentes maneiras de fazer isso:

• add_intent(simple_phrase): adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica.

• add_intent(simple_phrase, intent_id): adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica. Depois de reconhecida, a ID de intenção do resultado corresponderá à ID fornecida aqui.

• add_intent(model, intent_name): adiciona uma única intenção por nome do especificado LanguageUnderstandingModel.

• add_intent(model, intent_name, intent_id): adiciona uma única intenção por nome do especificado LanguageUnderstandingModel.

• add_intent(gatilho, intent_id): adiciona o IntentTrigger especificado. IntentTrigger.

add_intent(*args)

Parâmetros

Nome	Description
model Obrigatório	O modelo de reconhecimento vocal que contém a intenção.
intent_name Obrigatório	O nome da única intenção a ser incluída no modelo de compreensão da linguagem.
simple_phrase Obrigatório	A frase correspondente à intenção.
intent_id Obrigatório	Uma cadeia de caracteres de ID personalizada a ser retornada na IntentRecognitionResultpropriedade intent_id .
trigger Obrigatório	O IntentTrigger correspondente à intenção.

add_intents

Adicione intenções de um iterável sobre pares de (modelo, intent_id) ou (simple_phrase, intent_id).

add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])

Parâmetros

Nome	Description
intents Obrigatório	Intenções de um iterável sobre pares de (modelo, intent_id) ou (simple_phrase, intent_id) a serem reconhecidos.
intents_iter Obrigatório

recognize_once

Executa o reconhecimento em um modo de bloqueio (síncrono). É retornado depois que um único enunciado é reconhecido. O fim de um único enunciado é determinado pela escuta de silêncio no fim ou até o máximo de 15 segundos de áudio processado. A tarefa retorna o texto de reconhecimento como resultado. Para reconhecimento de múltiplas expressões de longa duração, use start_continuous_recognition_async.

recognize_once() -> IntentRecognitionResult

Retornos

Tipo	Description
	O valor do resultado do reconhecimento síncrono.

recognize_once_async

Executa o reconhecimento em um modo não bloqueado (assíncrono). Reconhecerá um único enunciado. O fim de um único enunciado é determinado pela escuta de silêncio no fim ou até o máximo de 15 segundos de áudio processado. Para reconhecimento de múltiplas expressões de longa duração, use start_continuous_recognition_async.

recognize_once_async() -> ResultFuture

Retornos

Tipo	Description
	Um futuro que contém o valor do resultado do reconhecimento assíncrono.

start_continuous_recognition

Inicia de forma síncrona a operação de reconhecimento contínuo. O usuário precisa se conectar a EventSignal para receber os resultados de reconhecimento. Chame stop_continuous_recognition_async para interromper o reconhecimento.

start_continuous_recognition()

start_continuous_recognition_async

Inicia de forma assíncrona a operação de reconhecimento contínuo. O usuário precisa se conectar a EventSignal para receber os resultados de reconhecimento. Chame stop_continuous_recognition_async para interromper o reconhecimento.

start_continuous_recognition_async() -> ResultFuture

Retornos

Tipo	Description
	Um futuro que é atendido depois que o reconhecimento é inicializado.

start_keyword_recognition

Configura de forma síncrona o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition() para encerrar o reconhecimento iniciado por palavra-chave.

start_keyword_recognition(model: KeywordRecognitionModel)

Parâmetros

Nome	Description
model Obrigatório	o modelo de reconhecimento de palavra-chave que especifica o palavra-chave a ser reconhecido.

start_keyword_recognition_async

Configura de forma assíncrona o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition_async() para encerrar o reconhecimento iniciado por palavra-chave.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parâmetros

Nome	Description
model Obrigatório	o modelo de reconhecimento de palavra-chave que especifica o palavra-chave a ser reconhecido.

Retornos

Tipo	Description
	Um futuro que é atendido depois que o reconhecimento é inicializado.

stop_continuous_recognition

Encerra de forma síncrona a operação de reconhecimento contínuo contínua.

stop_continuous_recognition()

stop_continuous_recognition_async

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

stop_continuous_recognition_async()

Retornos

Tipo	Description
	Um futuro que é atendido depois que o reconhecimento é interrompido.

stop_keyword_recognition

Termina de forma síncrona o reconhecimento iniciado por palavra-chave.

stop_keyword_recognition()

stop_keyword_recognition_async

Termina de forma assíncrona o reconhecimento iniciado por palavra-chave.

stop_keyword_recognition_async()

Retornos

Tipo	Description
	Um futuro que é atendido depois que o reconhecimento é interrompido.

Atributos

authorization_token

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 do

o token de autorização expira, o chamador precisa atualizá-lo chamando esse setter com um

novo token válido. Caso contrário, o reconhecedor encontrará erros durante o reconhecimento.

canceled

Sinal para eventos que contêm resultados de reconhecimento cancelados (indicando uma tentativa de reconhecimento que foi cancelada como resultado ou uma solicitação de cancelamento direto ou, como alternativa, uma falha de transporte ou protocolo).

Os retornos de chamada conectados a esse sinal são chamados com uma IntentRecognitionCanceledEventArgsinstância , como o argumento único.

endpoint_id

A ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento ou um modelo de voz personalizado para síntese de fala.

properties

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

recognized

Sinal para eventos que contêm resultados finais de reconhecimento (indicando uma tentativa de reconhecimento bem-sucedida).

Os retornos de chamada conectados a esse sinal são chamados com uma IntentRecognitionEventArgs instância como o argumento único, dependendo do tipo de reconhecedor.

recognizing

Sinal para eventos que contêm resultados de reconhecimento intermediários.

Os retornos de chamada conectados a esse sinal são chamados com uma IntentRecognitionEventArgs instância como o argumento único.

session_started

Sinal para eventos que indicam o início de uma sessão de reconhecimento (operação).

Os retornos de chamada conectados a esse sinal são chamados com uma SessionEventArgs instância como o argumento único.

session_stopped

Sinal para eventos que indicam o fim de uma sessão de reconhecimento (operação).

Os retornos de chamada conectados a esse sinal são chamados com uma SessionEventArgs instância como o argumento único.

speech_end_detected

Sinal para eventos que indicam o fim da fala.

Os retornos de chamada conectados a esse sinal são chamados com uma RecognitionEventArgs instância como o argumento único.

speech_start_detected

Sinal para eventos que indicam o início da fala.

Os retornos de chamada conectados a esse sinal são chamados com uma RecognitionEventArgs instância como o argumento único.