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 環境中運作，以辨識使用者對意圖和實體的輸入。

此類別會在 * 純 DialogContext 周圍建立 3 個虛擬方法模型（其中辨識發生在目前狀態 dialogcontext * Activity （其中辨識來自 Activity） * Text/Locale （其中辨識來自文字/地區設定）

DialogContext 方法的預設實作是使用 Context.Activity 並呼叫活動方法。 Activity 方法的預設實作是篩選至訊息活動，並提取文字/地區設定，並呼叫 text/locale 方法。

欄位摘要

修飾詞與類型 欄位與描述
static final java.lang.String CHOOSE_INTENT

如果子辨識器對意圖沒有共識，這個辨識器所產生的意圖名稱。
static final java.lang.String NONE_INTENT

標準無意圖，表示辨識器無法辨識意圖。

建構函式摘要

建構函式 Description
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)

使用辨識器Result 來建立追蹤遙測結果時要包含的 Proxy 清單。
java.lang.String getId()

取得辨識器的標識碼。
BotTelemetryClient getTelemetryClient()

取得目前設定的 Bot遙測用戶端，該客戶端會記錄辨識器Result 事件。
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)

設定辨識器的標識碼。
void setTelemetryClient(BotTelemetryClient withTelemetryClient)

設定目前設定的 BotTelemetryClient，以記錄辨識器Result 事件。
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 - 辨識器結果對應的辨識器標識碼。

傳回:

recognizerResult，即 ChooseIntent。

fillRecognizerResultTelemetryProperties

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

使用 RecognizerResult 建立追蹤遙測結果時要包含的 Proxy 清單。

參數:

recognizerResult - 辨識器結果。
telemetryProperties - 要附加或覆寫使用 RecognizerResult 建立的屬性清單。
dialogContext - 對話框內容。

傳回:

在 TelemetryClient 上呼叫 TrackEvent 方法時可以包含的字典。

getId

public String getId()

取得辨識器的標識碼。

傳回:

辨識器的標識碼

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)

設定辨識器的標識碼。

參數:

withId - 辨識器的標識碼

setTelemetryClient

public void setTelemetryClient(BotTelemetryClient withTelemetryClient)

設定目前設定的 BotTelemetryClient，以記錄 RecognizerResult 事件。

參數:

withTelemetryClient - BotTelemetryClient

trackRecognizerResult

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

使用附加屬性/計量的 TelemetryClient 來追蹤事件，並提供事件名稱。

參數:

dialogContext - 對話框內容。
eventName - 要追蹤的事件名稱。
telemetryProperties - 要包含在事件追蹤中的屬性。
telemetryMetrics - 要包含在事件追蹤中的計量。

適用於