Recognizer 类

  • 参考
包:
com.microsoft.bot.dialogs
Maven 项目:
com.microsoft.bot:bot-dialogs:4.14.3
  • java.lang.Object
    • com.microsoft.bot.dialogs.Recognizer

public class Recognizer

识别器基类。

识别器在 DialogContext 环境中运行，以识别用户对意向和实体的输入。

此类围绕 * Pure DialogContext（其中识别针对当前状态 dialogcontext * 活动（其中识别来自活动）* 文本/区域设置（其中识别来自文本/区域设置）为 3 个虚拟方法建模。

DialogContext 方法的默认实现是使用 Context.Activity 并调用活动方法。 活动方法的默认实现是筛选消息活动并提取文本/区域设置并调用文本/区域设置方法。

字段摘要

修饰符和类型 字段和描述
static final java.lang.String CHOOSE_INTENT

如果子识别器没有意向的共识，则此识别器将生成的意向名称。
static final java.lang.String NONE_INTENT

标准无意向，表示识别器均无法识别该意向。

构造函数摘要

构造函数 说明
Recognizer()

初始化新的识别器。

方法摘要

修饰符和类型 方法和描述
java.util.concurrent.CompletableFuture<T> <T>recognize(DialogContext dialogContext, Activity activity, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics, Class<T> c)

运行当前对话框上下文。轮次上下文。通过识别器活动，并使用识别器转换返回强类型识别器结果。
protected static RecognizerResult createChooseIntentResult(Map<String,RecognizerResult> recognizerResults)

返回多个识别器结果之间的“选择意向”。
protected java.util.Map<java.lang.String,java.lang.String> fillRecognizerResultTelemetryProperties(RecognizerResult recognizerResult, Map<String,String> telemetryProperties, DialogContext dialogContext)

使用识别器结果创建在遥测中跟踪结果时要包含的代理列表。
java.lang.String getId()

获取识别器 ID。
BotTelemetryClient getTelemetryClient()

获取当前配置的机器人遥测客户端，该客户端记录识别器结果事件。
java.util.concurrent.CompletableFuture<RecognizerResult> recognize(DialogContext dialogContext, Activity activity)

运行当前对话框上下文。轮次上下文。通过识别器活动并返回泛型识别器结果。
java.util.concurrent.CompletableFuture<RecognizerResult> recognize(DialogContext dialogContext, Activity activity, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics)

运行当前对话框上下文。轮次上下文。通过识别器活动并返回泛型识别器结果。
void setId(String withId)

设置识别器 ID。
void setTelemetryClient(BotTelemetryClient withTelemetryClient)

设置当前配置的机器人遥测客户端，用于记录识别器结果事件。
protected void trackRecognizerResult(DialogContext dialogContext, String eventName, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics)

使用遥测客户端附加属性/指标的事件名称跟踪事件。

方法继承自 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

字段详细信息

CHOOSE_INTENT

public static final String CHOOSE_INTENT

如果子识别器没有意向的共识，则此识别器将生成的意向名称。

NONE_INTENT

public static final String NONE_INTENT

标准无意向，表示识别器均无法识别该意向。 如果每个识别器不返回意向或 None 意向，则此识别器将返回 None 意向。

构造函数详细信息

Recognizer

public Recognizer()

初始化新的识别器。

方法详细信息

<T>recognize

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

通过识别器运行当前的 DialogContext.TurnContext.Activity，并使用 RecognizerConvert 返回强类型识别器结果。

参数:

dialogContext - 对话上下文。
activity - 要识别的活动。
telemetryProperties - 要作为事件跟踪的一部分包含的属性。
telemetryMetrics - 要包含在事件跟踪中的指标。
c - T 类型的类。

返回:

陈述分析。

createChooseIntentResult

protected static RecognizerResult createChooseIntentResult(Map recognizerResults)

返回多个识别器结果之间的 ChooseIntent。

参数:

recognizerResults - 用于识别器结果映射的识别器 ID。

返回:

recognizerResult，即 ChooseIntent。

fillRecognizerResultTelemetryProperties

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

使用 RecognizerResult 创建在跟踪遥测结果时要包含的代理列表。

参数:

recognizerResult - 识别器结果。
telemetryProperties - 要追加或重写使用 RecognizerResult 创建的属性的列表。
dialogContext - 对话上下文。

返回:

在 TelemetryClient 上调用 TrackEvent 方法时可以包含的字典。

getId

public String getId()

获取识别器 ID。

返回:

识别器 ID

getTelemetryClient

public BotTelemetryClient getTelemetryClient()

获取记录 RecognizerResult 事件的当前配置的 BotTelemetryClient。

返回:

BotTelemetryClient

recognize

public CompletableFuture recognize(DialogContext dialogContext, Activity activity)

通过识别器运行当前 DialogContext.TurnContext.Activity，并返回通用识别器结果。

参数:

dialogContext - 对话上下文。
activity - 要识别的活动。

返回:

陈述分析。

recognize

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

通过识别器运行当前 DialogContext.TurnContext.Activity，并返回通用识别器结果。

参数:

dialogContext - 对话上下文。
activity - 要识别的活动。
telemetryProperties - 要作为事件跟踪的一部分包含的属性。
telemetryMetrics - 要包含在事件跟踪中的指标。

返回:

陈述分析。

setId

public void setId(String withId)

设置识别器 ID。

参数:

withId - 识别器 ID

setTelemetryClient

public void setTelemetryClient(BotTelemetryClient withTelemetryClient)

设置记录 RecognizerResult 事件的当前配置的 BotTelemetryClient。

参数:

withTelemetryClient - BotTelemetryClient

trackRecognizerResult

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

使用 TelemetryClient 附加属性/指标时提供的事件名称跟踪事件。

参数:

dialogContext - 对话上下文。
eventName - 要跟踪的事件的名称。
telemetryProperties - 要作为事件跟踪的一部分包含的属性。
telemetryMetrics - 要包含在事件跟踪中的指标。

适用于