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: 発話内の値のセットを検索する低レベル関数。 や recognizeChoices() などのfindChoices()上位レベルの関数は、この関数の上に階層化されています。 ほとんどの場合、より高いレベルの関数の 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>

パラメーター

戻り値