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 (模拟 3 个虚拟方法，其中识别针对当前状态 dialogcontext * 活动 (，其中识别来自活动) * 文本/区域设置 (其中识别来自文本/区域设置)

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

字段摘要

修饰符和类型 字段和描述
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 返回强类型识别器结果。

Parameters:

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

Returns:

言语分析。

createChooseIntentResult

protected static RecognizerResult createChooseIntentResult(Map recognizerResults)

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

Parameters:

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

Returns:

recognizerResult，即 ChooseIntent。

fillRecognizerResultTelemetryProperties

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

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

Parameters:

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

Returns:

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

getId

public String getId()

获取识别器 ID。

Returns:

识别器 ID

getTelemetryClient

public BotTelemetryClient getTelemetryClient()

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

Returns:

BotTelemetryClient

recognize

public CompletableFuture recognize(DialogContext dialogContext, Activity activity)

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

Parameters:

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

Returns:

言语分析。

recognize

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

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

Parameters:

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

Returns:

言语分析。

setId

public void setId(String withId)

设置识别器 ID。

Parameters:

withId - 识别器 ID

setTelemetryClient

public void setTelemetryClient(BotTelemetryClient withTelemetryClient)

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

Parameters:

withTelemetryClient - BotTelemetryClient

trackRecognizerResult

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

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

Parameters:

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

适用于