This node module is an extension for Microsoft Bot Framework.
Use this library to define graph-based dialogs instead of the waterfall dialogs supported today. Also, instead of hard coding your dialogs, use this library to define your dialogs as jsons. These dialogs can be loaded dynamically from any external data source (db, file system, etc.)
Code sample for how to use this library can be found here.
npm install [--save] bot-graph-dialog
var builder = require('botbuilder');
var BotGraphDialog = require('bot-graph-dialog');
var connector = new builder.ChatConnector({
appId: '<microsoft_bot_id>',
appPassword: '<microsoft_bot_password>',
});
var bot = new builder.UniversalBot(connector);
var intents = new builder.IntentDialog();
bot.dialog('/', intents);
// handler for loading scenarios from external datasource
function loadScenario(scenario) {
return new Promise((resolve, reject) => {
console.log('loading scenario', scenario);
// implement loadScenario from external datasource.
var scenarioObj = ...
resolve(scenarioObj);
});
}
BotGraphDialog.GraphDialog
.fromScenario({
bot,
scenario: '<scenarioName>',
loadScenario
})
// attach stomach pain graph dialog to handle 'stomach' message
.then(graphDialog => intents.matches(/^stomach/i, graphDialog.getDialog()));See sample bot app here
Follow these samples as a reference to create your own scenarios.
Each step\scenario in the schema is recursive.
id- The id for the steptype[required] - The type of the step:textsequencepromptscoreheroCardcarouselhandlerend
steps- An array of steps or other scenariosmodels- see [#Models]
Display a text which can also be formatted with dialog variables.
Properties:
{
"type": "text",
"data": { "text": <required>"Text to print" }
}This step is a wrapper of one or more subsidiary steps.
Properties:
{
"id": <required>"step id",
"type": "sequence",
"steps": <required>[ {...}, {...} ]
}Prompt for a defined user response.
Properties:
{
"type": "prompt",
"data": {
"type": "text",
"text": <required>"Text to print with the prompt options"
}
}Prompt types can be one of:
text[default] - Prompts for free text. This options is set in case notypeproperty is providednumber- Request for a valid numbertime- Request for a time construct like "2 hours ago", "yesterday", etc.confirm- Yes \ No
Get a text from the user and resolve the intent against a single or multiple intent recognition (Luis) APIs.
Properties:
{
"id": <required>"intentId",
"type": "score",
"data": {
"models": <required>[ "model1", "model2" ]
},
"scenarios": <required>[
{
"condition": "intentId.intent == 'intent_1'",
"nodeId": "Node Id to jump to"
},
{
"condition": "intentId.intent == 'intent_2'",
"steps": [ { ... }, { ... } ]
},
{
"condition": "intentId.intent == 'intent_3'",
"steps": [ { "subScenario": "intent_3_scenario" } ]
}
]
}For models, see [#Models].
Under models, specify one or more models you have defined under models property.
Under scenarios, define a condition for expected intent and which scenario \ step it should jump to.
Creates a Hero Card, displaying images and using buttons
{
"id": "myCard",
"type": "heroCard",
"data": {
"title": "Space Needle",
"subtitle": "Our Subtitle",
"text": "The <b>Space Needle</b> is an observation tower in Seattle, Washington, a landmark of the Pacific Northwest, and an icon of Seattle.",
"images": [
"https://upload.wikimedia.org/wikipedia/commons/thumb/7/7c/Seattlenighttimequeenanne.jpg/320px-Seattlenighttimequeenanne.jpg"
],
"tap": {
"action": "openUrl",
"value": "https://en.wikipedia.org/wiki/Space_Needle"
},
"buttons": [
{
"label": "Wikipedia",
"action": "openUrl",
"value": "https://en.wikipedia.org/wiki/Space_Needle"
}
]
}
}Creates a Carousel control, which is a list of Hero Card controls in the same structure as demonstrated above:
{
"id": "myCarousel",
"type": "carousel",
"data": {
"text": "Can you see a carousel of hero cards bellow?",
"cards": [
]
}
}Enables providing a custom code to handle a specific step.
Properties:
{
"type": "handler",
"data": { "name": <required>"handler" }
}name the name for this handler. This will be provided to the callback for loading this handler.
The data that is collected during the dialog can be found in session.dialogData.data[<variable name>]
End the dialog and ignore any further steps.
Properties:
{
"type": "end",
"data": { "text": "Optional text to display before ending the conversation." }
}This property defined the models that can be used for intent recognition throughout the dialog.
{
"type": "sequence",
"steps": [ ... ],
"models": [
{
"name": "model1",
"url": "https://model1.url&q="
},
{
"name": "model2",
"url": "https://model2.url&q="
},
{
"name": "model3",
"url": "https://model3.url&q="
}
]
}When prompting or displaying text, it is possible to use a format to insert session variables like that:
{
"id": "userName",
"type": "prompt",
"data": {
"type": "text",
"text": "what is your name?"
}
},
{
"type": "text",
"data": { "text": "Welcome {userName}!" }
}There following validations are currently supported for validating user input. When a node contains a validation condition, the user will be prompted to provide the value until it satisfies the validation condition:
{
"id": "flightDate",
"type": "prompt",
"data": {
"type": "time",
"text": "When would you like to fly?",
"validation": {
"type": "date",
"setup": {
"min_date": "2016-11-15 00:00:00",
"max_date": "2016-11-25 23:59:59",
"invalid_msg": "Oops, wrong date!"
}
}
}
}{
"id": "isTesting",
"type": "prompt",
"data": {
"type": "text",
"text": "What are you doing? (I'll validate using regex: ^test)",
"validation": {
"type": "regex",
"setup": {
"pattern": "^test"
}
}
}
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent