botbuilder-dialogs package

発話内の選択肢を認識するための中間レベルの検索機能。

function findChoices(utterance: string, choices: string | Choice[], options?: FindChoicesOptions): ModelResult<FoundChoice>[]

パラメーター

戻り値

最も関連性の高い順に並べ替えられた、見つかった選択肢の一覧。

注釈

この関数は findValues() の上に階層化されており、実際の検索を実行するために findValues() を呼び出す前に検索する必要があるすべてのシノニムを単に決定します。 recognizeChoices() 関数は、この関数の上に階層化され、リスト内のインデックスまたは序数で選択を選択する機能を追加します。 この特定の関数を呼び出すことは、recognizeChoices()によってインデックスと序数位置の認識が行われないようにする場合に便利です。

const { findChoices } = require('botbuilder-choices');

const choices = ['red', 'green', 'blue'];
const utterance = context.activity.text;
const results = findChoices(utterance, choices);
if (results.length == 1) {
    await context.sendActivity(`I like ${results[0].resolution.value} too!`);
} else if (results.length > 1) {
    const ambiguous = results.map((r) => r.resolution.value);
    await context.sendActivity(ChoiceFactory.forChannel(context, ambiguous, `Which one?`));
} else {
    await context.sendActivity(ChoiceFactory.forChannel(context, choices, `I didn't get that... Which color?`));
}

INTERNAL: 発話内の値のセットを検索する低レベル関数。 findChoices() や recognizeChoices() などの上位レベルの関数は、この関数の上に階層化されています。 ほとんどの場合、より高いレベルの関数の 1 つを呼び出す方が簡単ですが、この関数には選択肢の認識を促進するあいまい検索アルゴリズムが含まれています。

function findValues(utterance: string, values: SortedValue[], options?: FindValuesOptions): ModelResult<FoundValue>[]

パラメーター

戻り値

見つかった値の一覧。

ユーザーの発話内の選択肢を認識するための高レベル関数。

function recognizeChoices(utterance: string, choices: string | Choice[], options?: FindChoicesOptions): ModelResult<FoundChoice>[]

パラメーター

戻り値

最も関連性の高い順に並べ替えられた、見つかった選択肢の一覧。

注釈

これは findChoices() 関数の上に重ねられ、ユーザーがインデックスで選択を指定できるようにするロジック ("1" を選択して choice[0]を選択できます) または序数位置 ("2 番目の位置" を指定して choice[1]を選択できるようにするロジックを追加します。ユーザーの発話は、次の順序で認識されます。

• findChoices()を使用して名前を指定します。
• 1 の基づく序数位置。
• 1 の基準インデックス位置。

const { recognizeChoices } = require('botbuilder-choices');

const choices = ['red', 'green', 'blue'];
const utterance = context.activity.text;
const results = recognizeChoices(utterance, choices);
if (results.length == 1) {
    await context.sendActivity(`I like ${results[0].resolution.value} too!`);
} else if (results.length > 1) {
    const ambiguous = results.map((r) => r.resolution.value);
    await context.sendActivity(ChoiceFactory.forChannel(context, ambiguous, `Which one?`));
} else {
    await context.sendActivity(ChoiceFactory.forChannel(context, choices, `I didn't get that... Which color?`));
}

スペースと句読点を区切る単純なトークナイザー。

function defaultTokenizer(text: string, _locale?: string): Token[]

パラメーター

戻り値

トークンの一覧。

注釈

行われる唯一の正規化は、トークンを小文字にすることです。 開発者は、このトークナイザーを独自の関数でラップして、ステミングなどの追加の正規化 実行できます。

const { recognizeChoices, defaultTokenizer } = require('botbuilder-choices');
const stemmer = require('stemmer');

function customTokenizer(text, locale) {
   const tokens = defaultTokenizer(text, locale);
   tokens.forEach((t) => {
       t.normalized = stemmer(t.normalized);
   });
   return tokens;
}

const choices = ['red', 'green', 'blue'];
const utterance = context.activity.text;
const results = recognizeChoices(utterance, choices, { tokenizer: customTokenizer });

DC スタックを再帰的にウォークアップして、アクティブな DC を見つけます。

function getActiveDialogContext(dialogContext: DialogContext): DialogContext

パラメーター

戻り値

Active DialogContext。

function internalRun(context: TurnContext, dialogId: string, dialogContext: DialogContext, dialogStateManagerConfiguration?: DialogStateManagerConfiguration): Promise<DialogTurnResult>

パラメーター

戻り値

ダイアログ ターンの結果に解決する Promise。

スキルがスキルの親として機能しているかどうかを判断します。

function isFromParentToSkill(context: TurnContext): boolean

パラメーター

戻り値

スキルがスキルの親として機能しているかどうかを表すブール値。

特定のコンテキストとアクセサーからダイアログを実行します。

function runDialog(dialog: Dialog, context: TurnContext, accessor: StatePropertyAccessor<DialogState>): Promise<void>

パラメーター

戻り値

親に EoC を送信する必要があるかどうかを判断するヘルパー。

function shouldSendEndOfConversationToParent(context: TurnContext, turnResult: DialogTurnResult): boolean

パラメーター

戻り値

EoC を送信する必要がある場合は True、それ以外の場合は false。

ComponentRegistration が ComponentMemoryScopes かどうかを確認します。

function isComponentMemoryScopes(component: unknown): boolean

パラメーター

戻り値

型チェックの結果。

ComponentRegistration が ComponentPathResolvers かどうかを確認します。

function isComponentPathResolvers(component: unknown): boolean

パラメーター

戻り値

型チェックの結果。

function createConnectorClient(context: TurnContext, serviceUrl: string, claimsIdentity: ClaimsIdentity, audience: string): Promise<ConnectorClient>

パラメーター

戻り値

function exchangeToken(context: TurnContext, settings: OAuthPromptSettings, tokenExchangeRequest: TokenExchangeRequest): Promise<TokenResponse>

パラメーター

戻り値

function getSignInResource(context: TurnContext, settings: OAuthPromptSettings): Promise<SignInUrlResponse>

パラメーター

戻り値

function getUserToken(context: TurnContext, settings: OAuthPromptSettings, magicCode: string): Promise<TokenResponse>

パラメーター

戻り値

function signOutUser(context: TurnContext, settings: OAuthPromptSettings): Promise<void>

パラメーター

戻り値