botbuilder-dialogs package

Référence

Classes

ChoiceFactory	Ensemble de fonctions utilitaires pour faciliter la mise en forme d’une activité « message » contenant une liste de choix.
ComponentDialog	Classe de base pour un dialogue qui contient d’autres dialogues enfants.
Configurable	Classe de base pour toutes les classes configurables.
Dialog	Définit le comportement principal de tous les dialogues.
DialogContainer	Conteneur pour un ensemble de dialogues.
DialogContext	Contexte du tour de dialogue actuel par rapport à un DialogSet spécifique.
DialogContextError	Erreur qui inclut un contexte de dialogue supplémentaire, y compris la pile de dialogues.
DialogEvents	Représente les événements liés au « cycle de vie » de la boîte de dialogue.
DialogManager	Classe qui exécute le système de dialogue.
DialogSet	Ensemble de dialogues connexes qui peuvent tous s’appeler les uns les autres.
DialogTurnStateConstants	Définit les constantes d’état de tour de boîte de dialogue.
DialogsBotComponent	Composant bot pour les dialogues de bot.
DialogsComponentRegistration	Met le composant dialogues à la disposition de la fonctionnalité d’inscription du système.
DialogPath	Définit le chemin des boîtes de dialogue disponibles.
DialogStateManager	DialogStateManager gère les étendues de mémoire et les programmes de résolution de chemin d’accès.
AliasPathResolver	Mappage aliasXXX -> path.xxx ($foo => dialog.foo).
AtAtPathResolver	Cartes @@ = tableau> turn.recognized.entitites.xxx.
AtPathResolver	Cartes @@ => turn.recognized.entitites.xxx[0]
DollarPathResolver	Cartes $xxx => dialog.xxx
HashPathResolver	Cartes #xxx => turn.recognized.intents.xxx
PercentPathResolver	Cartes %xxx => class.xxx (aka activeDialog.properties.xxx)
ScopePath	Définit les chemins d’accès pour les étendues disponibles.
BotStateMemoryScope	Classe de base pour les étendues de mémoire basées sur BotState.
ClassMemoryScope	ClassMemoryScope mappe « class » -> dc.activeDialog.properties
ConversationMemoryScope	Mémoire étendue à la conversation actuelle.
DialogClassMemoryScope	DialogClassMemoryScope mappe « dialogClass » -> dc.parent.activeDialog.properties
DialogContextMemoryScope	`DialogContextMemoryScope` mappe ' dialogcontext' - propriétés>.
DialogMemoryScope	DialogMemoryScope mappe « dialog » -> dc.parent.activeDialog.state \|\| dc.activeDialog.state
MemoryScope	Classe de base abstraite pour toutes les étendues de mémoire.
SettingsMemoryScope	SettingsMemoryScope mappe « settings » -> dc.context.turnState['settings']
ThisMemoryScope	ThisMemoryScope mappe « this » -> dc.activeDialog.state
TurnMemoryScope	TurnMemoryScope représente la mémoire délimitée au tour actuel.
UserMemoryScope	Mémoire étendue à l’utilisateur actuel.
ThisPath	Définit le chemin transmis à la boîte de dialogue active.
TurnPath	Définit le chemin des tours avaiables.
ActivityPrompt	Attend qu’une activité soit reçue.
AttachmentPrompt	Invite un utilisateur à charger des pièces jointes telles que des images.
ChoicePrompt	Invite un utilisateur à sélectionner dans une liste de choix.
ConfirmPrompt	Invite un utilisateur à confirmer quelque chose avec une réponse « oui » ou « non ».
DateTimePrompt	Invite un utilisateur à entrer une expression datetime.
NumberPrompt	Invite un utilisateur à entrer un nombre.
OAuthPrompt	Crée une invite qui demande à l’utilisateur de se connecter à l’aide du service Bot Frameworks Single Sign On (SSO).
Prompt	Classe de base pour toutes les invites.
PromptCultureModels	Conteneur de classes pour les modèles de culture actuellement pris en charge dans Confirm and Choice Prompt.
TextPrompt	Invite un utilisateur à entrer du texte.
Recognizer	Classe de base Recognizer.
SkillDialog	Boîte de dialogue spécialisée qui peut encapsuler les appels distants à une compétence.
WaterfallDialog	Une cascade est un dialogue optimisé pour inviter un utilisateur avec une série de questions.
WaterfallStepContext	Objet de contexte passé à un `WaterfallStep`.

Interfaces

BeginSkillDialogOptions	Classe avec des arguments de dialogue pour un SkillDialog.
ChoiceFactoryOptions	Options supplémentaires utilisées pour ajuster la mise en forme des listes de choix.
Choice	Instance d’un choix qui peut être utilisée pour restituer un choix à un utilisateur ou reconnaître un élément choisi par un utilisateur.
FindChoicesOptions	Options permettant de contrôler la reconnaissance effectuée par `findChoices()`.
FoundChoice	Résultat retourné par `findChoices()`.
FindValuesOptions	Options de recherche de base utilisées pour contrôler la façon dont les choix sont reconnus dans un énoncé d’utilisateurs.
FoundValue	INTERNAL : résultat de recherche brut retourné par `findValues()`.
SortedValue	INTERNAL : valeur qui peut être triée et qui fait toujours référence à sa position d’origine dans un tableau source. La fonction `findChoices()` développe les choix passés à des instances de `SortedValue` individuelles et les transmet à `findValues()`. Chaque `Choice` individuel peut entraîner plusieurs synonymes qui doivent être recherchés afin que cette structure de données nous permet de transmettre chaque synonyme en tant que valeur à rechercher tout en conservant l’index du choix de cette valeur.
ModelResult	Résultat externe retourné par un module de reconnaissance d’entité comme `recognizeChoices()`.
Token	Jeton individuel retourné par un `TokenizerFunction`.
Converter	Le convertisseur convertit l’objet d’un type en un autre.
DialogConfiguration
DialogEvent
DialogInstance	Contient des informations d’état pour une instance d’une boîte de dialogue sur la pile.
DialogTurnResult	Représente le résultat de la tentative de début, de poursuite ou de manipulation d’un ou plusieurs dialogues dans un contexte de dialogue.
DialogState	Contient l’état du dialogue, des informations sur l’état de la pile de dialogues, pour un DialogSet spécifique.
DialogManagerConfiguration
DialogManagerResult
DialogDependencies
ComponentMemoryScopes	Interface pour énumérer les étendues de mémoire.
ComponentPathResolvers	Interface permettant de déclarer des programme de résolution de chemin d’accès.
DialogStateManagerConfiguration
PathResolver	Copyright (c) Microsoft Corporation. Tous les droits réservés. Sous licence MIT.
ChoiceDefaultsChoicePrompt
ChoiceDefaultsConfirmPrompt
DateTimeResolution	Résultat retourné par le `DateTimePrompt`.
OAuthPromptSettings	Paramètres utilisés pour configurer une instance de `OAuthPrompt`.
PromptOptions	Options de configuration de base prises en charge par toutes les invites.
PromptRecognizerResult	Résultat retourné par une fonction de module de reconnaissance d’invite.
PromptValidatorContext	Informations contextuelles transmises à une `PromptValidator`personnalisée.
PromptCultureModel
RecognizerConfiguration
SkillDialogOptions
TemplateInterface	Définit l’interface de modèle pour la liaison de données à T.
WaterfallStepInfo	Valeurs transmises au constructeur `WaterfallStepContext`.

Alias de type

TokenizerFunction	Signature d’un autre analyseur de mots qui peut être transmis à `recognizeChoices()`, `findChoices()`ou `findValues()`. `type TokenizerFunction = (text: string, locale?: string) => Token[];`
ConverterFactory
PromptValidator	Signature de fonction pour fournir un validateur d’invite personnalisé. `type PromptValidator<T> = (prompt: PromptValidatorContext<T>) => Promise<boolean>;`
WaterfallStep	Signature de fonction d’une étape en cascade individuelle. `type WaterfallStep<O extends object = {}> = (step: WaterfallStepContext<O>) => Promise<DialogTurnResult>;`

Énumérations

DialogReason

Indique pourquoi une méthode de dialogue est appelée.

DialogTurnStatus

Représente l’état de la pile de dialogues après qu’un contexte de dialogue tente de commencer, de continuer ou de manipuler un ou plusieurs dialogues. Voir également

DialogContext
boîte de dialogue

ListStyle

Contrôle la façon dont les choix d’une ChoicePrompt ou des options oui/non pour un ConfirmPrompt sont présentés à un utilisateur.

Functions

findChoices(string, string \| Choice[], FindChoicesOptions)	Fonction de recherche de niveau intermédiaire pour reconnaître un choix dans un énoncé.
findValues(string, SortedValue[], FindValuesOptions)	INTERNAL : fonction de bas niveau qui recherche un ensemble de valeurs dans un énoncé. Les fonctions de niveau supérieur comme `findChoices()` et les `recognizeChoices()` sont superposées au-dessus de cette fonction. Dans la plupart des cas, il est plus facile d’appeler l’une des fonctions de niveau supérieur à la place, mais cette fonction contient l’algorithme de recherche approximative qui pilote la reconnaissance de choix.
recognizeChoices(string, string \| Choice[], FindChoicesOptions)	Fonction de haut niveau pour reconnaître un choix dans un énoncé d’utilisateurs.
defaultTokenizer(string, string)	Tokenizer simple qui s’interrompt sur les espaces et la ponctuation.
getActiveDialogContext(DialogContext)	Parcourez de manière récursive la pile dc pour trouver le contrôleur de domaine actif.
internalRun(TurnContext, string, DialogContext, DialogStateManagerConfiguration)
isFromParentToSkill(TurnContext)	Détermine si la compétence agit en tant que parent de compétence.
runDialog(Dialog, TurnContext, StatePropertyAccessor<DialogState>)	Exécute une boîte de dialogue à partir d’un contexte et d’un accesseur donnés.
shouldSendEndOfConversationToParent(TurnContext, DialogTurnResult)	Assistance pour déterminer si nous devrions envoyer un EoC au parent ou non.
isComponentMemoryScopes(unknown)	Vérifiez si un ComponentRegistration est ComponentMemoryScopes ou non.
isComponentPathResolvers(unknown)	Vérifiez si un ComponentRegistration est ComponentPathResolvers ou non.
createConnectorClient(TurnContext, string, ClaimsIdentity, string)
exchangeToken(TurnContext, OAuthPromptSettings, TokenExchangeRequest)
getSignInResource(TurnContext, OAuthPromptSettings)
getUserToken(TurnContext, OAuthPromptSettings, string)
signOutUser(TurnContext, OAuthPromptSettings)

Informations relatives à la fonction

findChoices(string, string | Choice[], FindChoicesOptions)

Fonction de recherche de niveau intermédiaire pour reconnaître un choix dans un énoncé.

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

Paramètres

utterance: string

Texte ou énoncé utilisateur à rechercher. Pour une activité « message » entrante, vous pouvez simplement utiliser context.activity.text.

choices: string | Choice[]

Liste des choix à rechercher.

options: FindChoicesOptions

(Facultatif) options utilisées pour ajuster la recherche effectuée.

Retours

ModelResult<FoundChoice>[]

Une liste de choix trouvés, triée par priorité la plus pertinente.

Remarques

Cette fonction est superposée au-dessus de findValues() et détermine simplement tous les synonymes qui doivent être recherchés avant d’appeler findValues() pour effectuer la recherche réelle. La fonction recognizeChoices() est superposée au-dessus de cette fonction et ajoute la possibilité de sélectionner un choix par index ou position ordinale dans la liste. L’appel de cette fonction particulière est utile lorsque vous ne souhaitez pas que l’index et la reconnaissance de position ordinale soient effectuées par 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?`));
}

findValues(string, SortedValue[], FindValuesOptions)

INTERNAL : fonction de bas niveau qui recherche un ensemble de valeurs dans un énoncé. Les fonctions de niveau supérieur comme findChoices() et les recognizeChoices() sont superposées au-dessus de cette fonction. Dans la plupart des cas, il est plus facile d’appeler l’une des fonctions de niveau supérieur à la place, mais cette fonction contient l’algorithme de recherche approximative qui pilote la reconnaissance de choix.

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

Paramètres

utterance: string

Texte ou énoncé utilisateur à rechercher.

values: SortedValue[]

Liste des valeurs à rechercher.

options: FindValuesOptions

(Facultatif) options utilisées pour ajuster la recherche effectuée.

Retours

ModelResult<FoundValue>[]

Liste des valeurs trouvées.

recognizeChoices(string, string | Choice[], FindChoicesOptions)

Fonction de haut niveau pour reconnaître un choix dans un énoncé d’utilisateurs.

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

Paramètres

utterance: string

Texte ou énoncé utilisateur à rechercher. Pour une activité « message » entrante, vous pouvez simplement utiliser context.activity.text.

choices: string | Choice[]

Liste des choix à rechercher.

options: FindChoicesOptions

(Facultatif) options utilisées pour ajuster la recherche effectuée.

Retours

ModelResult<FoundChoice>[]

Une liste de choix trouvés, triée par priorité la plus pertinente.

Remarques

Cela est superposé au-dessus de la fonction findChoices() et ajoute une logique pour permettre à l’utilisateur de spécifier son choix par index (il peut dire « un » pour choisir choice[0]) ou une position ordinale (ils peuvent dire « la seconde » pour choisir choice[1].) L’énoncé des utilisateurs est reconnu dans l’ordre suivant :

Par nom à l’aide de findChoices().
Par 1 position ordinale basée.
Par 1 position d’index de base.

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?`));
}

defaultTokenizer(string, string)

Tokenizer simple qui s’interrompt sur les espaces et la ponctuation.

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

Paramètres

text: string

Texte d’entrée.

_locale: string

Facultatif, identifie les paramètres régionaux du texte d’entrée.

Retours

Token[]

Liste des jetons.

Remarques

La seule normalisation effectuée consiste à minusculer les jetons. Les développeurs peuvent encapsuler ce tokenizer avec leur propre fonction pour effectuer une normalisation supplémentaire comme .

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 });

getActiveDialogContext(DialogContext)

Parcourez de manière récursive la pile dc pour trouver le contrôleur de domaine actif.

function getActiveDialogContext(dialogContext: DialogContext): DialogContext

Paramètres

dialogContext: DialogContext

(xref :botbuilder-dialogs. DialogContext) pour le tour actuel de conversation avec l’utilisateur.

Retours

DialogContext

dialogContext actif.

internalRun(TurnContext, string, DialogContext, DialogStateManagerConfiguration)

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

Paramètres

context: TurnContext

TurnContext pour le tour.

dialogId: string

ID de boîte de dialogue.

dialogContext: DialogContext

DialogContext pour le tour de conversation actuel.

dialogStateManagerConfiguration: DialogStateManagerConfiguration

Configuration du gestionnaire d’état de boîte de dialogue.

Retours

Promise<DialogTurnResult>

une promesse de résolution du résultat du tour de dialogue.

isFromParentToSkill(TurnContext)

Détermine si la compétence agit en tant que parent de compétence.

function isFromParentToSkill(context: TurnContext): boolean

Paramètres

context: TurnContext

(xref :botbuilder-core. Objet TurnContext) pour le tour de conversation actuel avec l’utilisateur.

Retours

boolean

Valeur booléenne représentant si la compétence agit en tant que parent de compétence.

runDialog(Dialog, TurnContext, StatePropertyAccessor<DialogState>)

Exécute une boîte de dialogue à partir d’un contexte et d’un accesseur donnés.

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

Paramètres

dialog: Dialog

Boîte de dialogue à exécuter.

context: TurnContext

(xref :botbuilder-core. Objet TurnContext) pour le tour de conversation actuel avec l’utilisateur.

accessor: StatePropertyAccessor<DialogState>

Méthodes définies pour accéder à la propriété d’état créée dans un objet BotState.

Retours

Promise<void>

shouldSendEndOfConversationToParent(TurnContext, DialogTurnResult)

Assistance pour déterminer si nous devrions envoyer un EoC au parent ou non.

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

Paramètres

context: TurnContext

TurnContext pour le tour.

turnResult: DialogTurnResult

Résultat du tour du dialogue.

Retours

boolean

True si elle doit envoyer EoC, sinon false.

isComponentMemoryScopes(unknown)

Vérifiez si un ComponentRegistration est ComponentMemoryScopes ou non.

function isComponentMemoryScopes(component: unknown): boolean

Paramètres

component: unknown

Inscription du composant.

Retours

boolean

Résultat de la vérification de type.

isComponentPathResolvers(unknown)

Vérifiez si un ComponentRegistration est ComponentPathResolvers ou non.

function isComponentPathResolvers(component: unknown): boolean

Paramètres

component: unknown

Inscription du composant.

Retours

boolean

Résultat de la vérification de type.

createConnectorClient(TurnContext, string, ClaimsIdentity, string)

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

Paramètres

context: TurnContext

serviceUrl: string

claimsIdentity: ClaimsIdentity

audience: string

Retours

Promise<ConnectorClient>

exchangeToken(TurnContext, OAuthPromptSettings, TokenExchangeRequest)

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

Paramètres

context: TurnContext

settings: OAuthPromptSettings

tokenExchangeRequest: TokenExchangeRequest

Retours

Promise<TokenResponse>

getSignInResource(TurnContext, OAuthPromptSettings)

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

Paramètres

context: TurnContext

settings: OAuthPromptSettings

Retours

Promise<SignInUrlResponse>

getUserToken(TurnContext, OAuthPromptSettings, string)

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

Paramètres

context: TurnContext

settings: OAuthPromptSettings

magicCode: string

Retours

Promise<TokenResponse>

signOutUser(TurnContext, OAuthPromptSettings)

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

Paramètres

context: TurnContext

settings: OAuthPromptSettings

Retours

Promise<void>

Partager via

botbuilder-dialogs package

Classes

Interfaces

Alias de type

Énumérations

Functions

Informations relatives à la fonction

findChoices(string, string | Choice[], FindChoicesOptions)

Paramètres

Retours

Remarques

findValues(string, SortedValue[], FindValuesOptions)

Paramètres

Retours

recognizeChoices(string, string | Choice[], FindChoicesOptions)

Paramètres

Retours

Remarques

defaultTokenizer(string, string)

Paramètres

Retours

Remarques

getActiveDialogContext(DialogContext)

Paramètres

Retours

internalRun(TurnContext, string, DialogContext, DialogStateManagerConfiguration)

Paramètres

Retours

isFromParentToSkill(TurnContext)

Paramètres

Retours

runDialog(Dialog, TurnContext, StatePropertyAccessor<DialogState>)

Paramètres

Retours

shouldSendEndOfConversationToParent(TurnContext, DialogTurnResult)

Paramètres

Retours

isComponentMemoryScopes(unknown)

Paramètres

Retours

isComponentPathResolvers(unknown)

Paramètres

Retours

createConnectorClient(TurnContext, string, ClaimsIdentity, string)

Paramètres

Retours

exchangeToken(TurnContext, OAuthPromptSettings, TokenExchangeRequest)

Paramètres

Retours

getSignInResource(TurnContext, OAuthPromptSettings)

Paramètres

Retours

getUserToken(TurnContext, OAuthPromptSettings, string)

Paramètres

Retours

signOutUser(TurnContext, OAuthPromptSettings)

Paramètres

Retours