Recognizer Classe

  • Referência
Pacote:
com.microsoft.bot.dialogs
Artefato Maven:
com.microsoft.bot:bot-dialogs:4.14.3
  • java.lang.Object
    • com.microsoft.bot.dialogs.Recognizer

public class Recognizer

Classe base do reconhecedor.

Os reconhecedores operam em um ambiente DialogContext para reconhecer a entrada do usuário em Intenções e Entidades.

Essa classe modela 3 métodos virtuais em torno de * Pure DialogContext (em que o reconhecimento ocorre em relação ao dialogcontext de estado atual * Atividade (em que o reconhecimento é de uma atividade) * Texto/Localidade (em que o reconhecimento é de texto/localidade)

A implementação padrão do método DialogContext é usar Context.Activity e chamar o método de atividade. A implementação padrão do método Atividade é filtrar para atividades de mensagem e efetuar pull de texto/localidade e chamar o método de texto/localidade.

Resumo do campo

Modificador e tipo Campo e descrição
static final java.lang.String CHOOSE_INTENT

Nome da intenção que será produzido por esse reconhecedor se os reconhecedores filho não tiverem consenso para intenções.
static final java.lang.String NONE_INTENT

Nenhuma intenção padrão que significa que nenhum dos reconhecedores reconhece a intenção.

Resumo do Construtor

Construtor Description
Recognizer()

Inicializa um novo Reconhecedor.

Resumo do método

Modificador e tipo Método e descrição
java.util.concurrent.CompletableFuture<T> <T>recognize(DialogContext dialogContext, Activity activity, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics, Class<T> c)

Executa a caixa de diálogo atualContexto.Contexto.Atividade por meio de um reconhecedor e retorna um resultado de reconhecedor fortemente tipado usando o ReconhecedorConverter.
protected static RecognizerResult createChooseIntentResult(Map<String,RecognizerResult> recognizerResults)

Retorna EscolhaIntenção entre vários resultados do reconhecedor.
protected java.util.Map<java.lang.String,java.lang.String> fillRecognizerResultTelemetryProperties(RecognizerResult recognizerResult, Map<String,String> telemetryProperties, DialogContext dialogContext)

Usa o ReconhecedorResultado para criar uma lista de propeties a serem incluídas ao acompanhar o resultado em telemetria.
java.lang.String getId()

Obtém a ID do reconhecedor.
BotTelemetryClient getTelemetryClient()

Obtém o Cliente dede Telemetria do Botconfigurado no momento que registra o evento RecognizerResult.
java.util.concurrent.CompletableFuture<RecognizerResult> recognize(DialogContext dialogContext, Activity activity)

Executa a caixa de diálogo atualContexto.Contexto.Atividade por meio de um reconhecedor e retorna um resultado de reconhecedor genérico.
java.util.concurrent.CompletableFuture<RecognizerResult> recognize(DialogContext dialogContext, Activity activity, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics)

Executa a caixa de diálogo atualContexto.Contexto.Atividade por meio de um reconhecedor e retorna um resultado de reconhecedor genérico.
void setId(String withId)

Define a ID do reconhecedor.
void setTelemetryClient(BotTelemetryClient withTelemetryClient)

Define o Cliente dede Telemetria do Botconfigurado no momento que registra o evento RecognizerResult.
protected void trackRecognizerResult(DialogContext dialogContext, String eventName, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics)

Controla um evento com o nome do evento fornecido usando a TelemetriaCliente anexando as propriedades/métricas.

Métodos herdados de java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Detalhes do campo

CHOOSE_INTENT

public static final String CHOOSE_INTENT

Nome da intenção que será produzido por esse reconhecedor se os reconhecedores filho não tiverem consenso para intenções.

NONE_INTENT

public static final String NONE_INTENT

Nenhuma intenção padrão que significa que nenhum dos reconhecedores reconhece a intenção. Se cada reconhecedor não retornar nenhuma intenção ou nenhuma intenção, esse reconhecedor retornará Nenhuma intenção.

Detalhes do construtor

Recognizer

public Recognizer()

Inicializa um novo Reconhecedor.

Detalhes do método

<T>recognize

public CompletableFuture recognize(DialogContext dialogContext, Activity activity, Map telemetryProperties, Map telemetryMetrics, Class c)

Executa DialogContext.TurnContext.Activity atual por meio de um reconhecedor e retorna um resultado de reconhecedor fortemente tipado usando RecognizerConvert.

Parâmetros:

dialogContext - Contexto da caixa de diálogo.
activity - atividade a ser reconhecida.
telemetryProperties - As propriedades a serem incluídas como parte do acompanhamento de eventos.
telemetryMetrics - As métricas a serem incluídas como parte do acompanhamento de eventos.
c - Classe do tipo T.

Retornos:

Análise de enunciado.

createChooseIntentResult

protected static RecognizerResult createChooseIntentResult(Map recognizerResults)

Retorna ChooseIntent entre vários resultados do reconhecedor.

Parâmetros:

recognizerResults - ID do reconhecedor para o mapa de resultados do reconhecedor.

Retornos:

recognizerResult, que é ChooseIntent.

fillRecognizerResultTelemetryProperties

protected Map fillRecognizerResultTelemetryProperties(RecognizerResult recognizerResult, Map telemetryProperties, DialogContext dialogContext)

Usa o RecognizerResult para criar uma lista de propeties a serem incluídas ao acompanhar o resultado em telemetria.

Parâmetros:

recognizerResult - Resultado do Reconhecedor.
telemetryProperties - Uma lista de propriedades para acrescentar ou substituir as propriedades criadas usando o RecognizerResult.
dialogContext - Contexto da caixa de diálogo.

Retornos:

Um dicionário que pode ser incluído ao chamar o método TrackEvent no TelemetryClient.

getId

public String getId()

Obtém a ID do reconhecedor.

Retornos:

ID do reconhecedor

getTelemetryClient

public BotTelemetryClient getTelemetryClient()

Obtém o BotTelemetryClient configurado no momento que registra o evento RecognizerResult.

Retornos:

BotTelemetryClient

recognize

public CompletableFuture recognize(DialogContext dialogContext, Activity activity)

Executa DialogContext.TurnContext.Activity atual por meio de um reconhecedor e retorna um resultado de reconhecedor genérico.

Parâmetros:

dialogContext - Contexto da caixa de diálogo.
activity - atividade a ser reconhecida.

Retornos:

Análise de enunciado.

recognize

public CompletableFuture recognize(DialogContext dialogContext, Activity activity, Map telemetryProperties, Map telemetryMetrics)

Executa DialogContext.TurnContext.Activity atual por meio de um reconhecedor e retorna um resultado de reconhecedor genérico.

Parâmetros:

dialogContext - Contexto da caixa de diálogo.
activity - atividade a ser reconhecida.
telemetryProperties - As propriedades a serem incluídas como parte do acompanhamento de eventos.
telemetryMetrics - As métricas a serem incluídas como parte do acompanhamento de eventos.

Retornos:

Análise de enunciado.

setId

public void setId(String withId)

Define a ID do reconhecedor.

Parâmetros:

withId - ID do reconhecedor

setTelemetryClient

public void setTelemetryClient(BotTelemetryClient withTelemetryClient)

Define o BotTelemetryClient configurado no momento que registra o evento RecognizerResult.

Parâmetros:

withTelemetryClient - BotTelemetryClient

trackRecognizerResult

protected void trackRecognizerResult(DialogContext dialogContext, String eventName, Map telemetryProperties, Map telemetryMetrics)

Controla um evento com o nome do evento fornecido usando o TelemetryClient anexando as propriedades/métricas.

Parâmetros:

dialogContext - Contexto da caixa de diálogo.
eventName - O nome do evento a ser rastreado.
telemetryProperties - As propriedades a serem incluídas como parte do acompanhamento de eventos.
telemetryMetrics - As métricas a serem incluídas como parte do acompanhamento de eventos.

Aplica-se a