Reco Analyze Result

This Reco tool can be used to determine how to proceed with the result of a recognition. Usually, if there is a single result with a high confidence, it is immediately accepted and the dialog proceeds. If there is a single result with a lower confidence, it should not immediately be accepted but rather a confirmation should be obtained (e.g., "did you say John Doe?"). If there are multiple results that match the criteria, the handler has to disambiguate, for example by querying the user for the individual results (e.g., "There are multiple matches. Did you mean Mary Smith?" – "No" – "Mary Smythe?" – "Yes").

IMPORTANT: This tool only works correctly if the hypotheses in the recognition result passed as argument are in descending order of confidence. This will always be the case if the result data comes from one of the recognition tools.

Inputs

Recognition Result

XML DOM node of the ASR recognition result XML document (e.g. returned by Reco Input).

Acceptance Confidence

Minimum confidence score for results that are accepted without confirmation. Default: 0.85

Confirmation Confidence

Minimum confidence score for results that have to be confirmed. All results lower than this threshold will be ignored. Default: 0.2

Threshold Diffusion

This parameter is used to achieve a smart inclusion of results that might fall below the threshold, but that are statistically too similar to acceptable results to be excluded without confirmation. For example, consider a scenario where a recognition result has two hypotheses, one with a confidence of 0.87 and the other 0.83, and the Confirmation Confidence is 0.85. Only one of those two hypotheses is above the threshold of 0.85, however the one that is not is close enough to it that it would be reasonable to prompt the user before discarding it.

After all hypotheses that are above the acceptance or confirmation threshold have been found, the score of the hypothesis with the lowest score is multiplied by [1.0 – ThresholdDiffusion]. This value is then used as a new threshold and all hypotheses that are above this value are included too.

The default value of for this parameter is 0.05.

Outputs

Top Hypothesis

XML DOM Node of the <hypothesis> element with the highest score in its band. NULL node if no matching hypothesis found. This parameter will contain the top hypothesis even if there were multiple matches.

Hypotheses

XML node iterator to iterate over the hypotheses that match the criteria. The Top Hypothesis is the first one that will be returned by the XML Get Next Node tool.

Hypothesis Count

Number of hypotheses in the Hypotheses list.

Exit Paths

Accept Single

This path is taken if a single hypothesis is above the accept threshold.

Accept Multiple

This path is taken if multiple hypotheses are above the accept threshold.

Confirm Single

This path is taken if a single hypothesis is below the accept threshold but above the confirm threshold. This hypothesis should be confirmed with the caller.

Confirm Multiple

This path is taken if multiple hypotheses are below the accept threshold but above the confirm threshold. These hypotheses have to be confirmed.

Rejected

This path is taken if there are hypotheses in the recognition result, but they are all below the Confirm Confidence.

None

This path is taken if the recognition result is empty (no hypotheses) or the XML node is NULL.

Failure

This path is taken if an error occurred (e.g., not a recognition result).