OVERVIEW
Virtual Assistants
Kore.ai Platform
Key Concepts
Natural Language Processing (NLP)
Accessing Platform
VIRTUAL ASSISTANTS
Virtual Assistant Builder
Virtual Assistant Types
Getting Started
Create a Simple Bot
SKILLS
Storyboard
Dialog Tasks
Introduction
Dialog Builder (New)
Dialog Builder (Legacy)
User Intent Node
Dialog Node
Entity Node
Supported Entity Types
Composite Entities
Supported Colors
Supported Company Names
Form Node
Logic Node
Message Nodes
Confirmation Nodes
Bot Action Node
Service Node
Custom Authentication
2-way SSL for Service nodes
Script Node
Agent Transfer Node
WebHook Node
Grouping Nodes
Connections & Transitions
Manage Dialogs
User Prompts
Knowledge Graph
Terminology
Building
Generation
Importing and Exporting
Analysis
Knowledge Extraction
Train
Build
Alert Tasks
Introduction
Ignore Words and Field Memory
How to Schedule a Smart Alert
Small Talk
Digital Views
Introduction
How to Configure Digital Views
Digital Forms
Overview
How to Configure Digital Forms
NATURAL LANGUAGE
Overview
Machine Learning
Introduction
Model Validation
Fundamental Meaning
Introduction
NLP Guidelines
Knowledge Graph
Traits
Introduction
How to Use Traits
Ranking and Resolver
Advanced NLP Configurations
INTELLIGENCE
Overview
Context Management
Overview
Session and Context Variables
Context Object
How to Manage Context Switching
Manage Interruptions
Dialog Management
Sub Intents & Follow-up Intents
Amend Entity
Multi-Intent Detection
Sentiment Management
Tone Analysis
Sentiment Management
Event Based Bot Actions
Default Conversations
Default Standard Responses
TEST & DEBUG
Talk to Bot
Utterance Testing
Batch Testing
Record Conversations
Conversation Testing
CHANNELS
PUBLISH
ANALYZE
Overview
Dashboard
Custom Dashboard
Overview
How to Create Custom Dashboard
Conversation Flows
NLP Metrics
ADVANCED TOPICS
Universal Bots
Overview
Defining
Creating
Training
Customizing
Enabling Languages
Store
Smart Bots
Defining
koreUtil Libraries
SETTINGS
Authorization
Language Management
PII Settings
Variables
Functions
IVR Integration
General Settings
Management
Import & Export
Delete
Bot Versioning
Collaborative Development
Plan Management
API GUIDE
API Overview
API List
API Collection
SDKs
SDK Overview
SDK Security
SDK App Registration
Web SDK Tutorial
Message Formatting and Templates
Mobile SDK Push Notification
Widget SDK Tutorial
Widget SDK – Message Formatting and Templates
Web Socket Connect & RTM
Using the BotKit SDK
Installing
Configuring
Events
Functions
BotKit SDK Tutorial – Agent Transfer
BotKit SDK Tutorial – Flight Search Sample Bot
Using an External NLP Engine
ADMINISTRATION
HOW TOs
Create a Simple Bot
Create a Banking Bot
Transfer Funds Task
Update Balance Task
Context Switching
Using Traits
Schedule a Smart Alert
Configure UI Forms
Add Form Data into Data Tables
Configuring Digital Views
Add Data to Data Tables
Update Data in Data Tables
Custom Dashboard
Custom Tags to filter Bot Metrics
Patterns for Intents & Entities
Build Knowledge Graph
Global Variables
Content Variables
Using Bot Functions
Configure Agent Transfer
RELEASE NOTES

Conversation-driven Dialog Builder

Conversation Builder is a new dialog task editor which allows you to design and build a dialog task using conversational elements. It leverages the features of Storyboard and the Flow-based Dialog Task Builder.

While the Storyboard helps in designing and visualizing the user conversations, the bot needs to be developed in the Dialog Task Builder. This involves a manual effort in understanding and converting the conversation components into dialog components. Oftentimes, a lot gets missed in the translation. Validation of a Dialog against a Scene also requires significant manual effort and there is not much collaboration between a conversation designer/BA and the implementation engineers due to the different implementation styles. Also, the ongoing changes in the Scene or in the Dialog need to be manually synchronized and can get very complicated

Conversation-driven Dialog builder automatically converts the storyboard scenes into a Dialog Task. Designers can focus on visualizing the end-user conversation before building the dialog. Since the conversation flow is automatically generated, developers can focus on the more technical aspects. This not only reduces the development effort but also ensures that the bot is closer to the actual design.

This feature was released with v9.0 of the platform and is in (beta) state.

Features

  • An integrated approach for conversation designers (or business analysts) and developers to collaboratively build a dialog.
  • Ability to define a dialog in a conversation view – conversation designers or BAs can design the bot in this view as a series of bot messages and user messages.
  • Auto-generation of tasks in the build view – the developers can fine-tune the configurations and expand on top of the conversation flow to provide the necessary logic and fulfillment elements leading to a fully functional bot.
  • Improved usability and intuitiveness.
  • Automatic sync between the views i.e changes to one view updates the other.

Conversation View

BAs/Conversation Designers can define a dialog in conversation view. This view consists of a conversation flow as a series of bot messages and user messages. Where appropriate, BAs can add Action nodes that would be configured during the bot development.
The Build -> Conversation Skills -> Storyboard gives you an exclusive conversation view with an option to switch to the conversation flow. It can also be viewed at the left bottom window from the new Dialog Builder.


NOTE: This document lists the features available exclusively in the conversation builder. This is in addition to the features available on Storyboard that are common to both storyboard and conversation builder. For the common features refer here.

Build View

The conversation view can be expanded by providing the necessary logic and fulfillment elements in the Build View. This is the new dialog builder with the options to drag and drop or add the necessary nodes. The entity, message, and other nodes along with the appropriate connections are generated automatically based on the conversation designed by the BA/conversation designer. Developer can make configuration changes and add appropriate service calls etc. to make it a fully functional bot.
You can access this view either by clicking View Dialog from the Conversation view (as seen above) or from Build -> Conversation Skills -> Dialog Tasks.

Conversation Builder

Let us now look into creating a scene and using the various features available in a conversation builder.

Conversation builder can be accessed in two ways:

  • From storyboard by creating a new scene
  • From dialog task by creating a new dialog

Create Scene

  1. Open the bot you want to design the conversation
  2. Select the Build tab from the top menu
  3. From the left menu, click Conversation Skills -> Storyboard
  4. Click New Scene and enter the following details
    • Scene Name
    • Description
    • Status of the scene
    • Select Auto-generate a Dialog Task option. This will ensure that a dialog task is automatically created in the background as you build the scene.

Create Dialog

You can initiate Conversation Driven Dialog Builder from the Create Dialog flow

  1. Open the bot you want to design the conversation
  2. Select the Build tab from the top menu
  3. From the left menu, click Conversation Skills -> Dialog Task
  4. Click Create Dialog and enter the following details
    • Intent Name
    • Description
    • Intent Training – enter utterances that would trigger this intent
    • Select Try Conversation Driven Dialog Builder option. This will give you allow you to design a conversation and simultaneously view and define the corresponding dialog task.

Basic Features

NOTE: In the following sections, we will be looking into the different aspects of Conversation Builder. Though the screenshots represent the Storyboard flow they are valid for the Dialog task flow also.

Intent Node

  1. Once you create a scene or dialog task, a Primary Intent is created by default. This is taken as the User Utterance that triggers this scene/dialog.
  2. Click the more option and select Configuration Properties
    • change Display Name and Node Name if needed
    • add/change Description
    • Add utterance that would trigger this intent. You can add multiple utterances. These would be in addition to the primary intent utterance.

  3. You have the option to Manage Training which will enable you to train the intent by adding Utterances, Patterns, and Rules. Refer here for more on utterance training.

Bot Message

The first thing you want to start with, in the conversation, is a message from the bot to the user. This would serve as a guide to the user on the conversation flow.
Bot Messages can serve one of the following purposes:

  • Ask a Question with the intention of gathering information from the user. This gets converted to an Entity node in the dialog task.
    • You can further specify the type of user input expected like string, number, date, etc. It gets translated to an entity type in the dialog task
    • You can format the message using simple formatting options or by selecting a template for presenting the bot message
  • Ask Confirmation with the intention to decide the path of the conversation. This gets converted to a Confirmation node in the dialog task.
  • Inform the User like a help message, welcome message, or as a response to the user query. These get converted to a Message node in the dialog task.

For each of the above selections, you can either use an existing node by selecting from the list or create a new node.

User Response

Every bot message is ideally followed by a user response. User Response can be used to define the conversation flow by predicting the user response. For example, the bot might have asked the user to confirm an input, then based on the response there would be two paths – one for affirmation and one for negation.
Note: If not specified, the platform adds a Sample User Response placeholder to maintain the sanctity of the conversational flow.

Other Nodes

Apart from  Bot and User Messages, you can

  • add placeholders for Bot Actions like service calls, scripts, logic, webhook and process to define the flow, and more. The actual functionality needs to be added from the dialog builder. You can leave comments for the developer elaborating the purpose of such a bot action node. For example, for the Book Flight task, you want to connect to your backend servers for the actual booking process.
  • trigger Dialog Tasks for subtasks or related/follow-up tasks. For example, after booking a flight you might want to trigger the Web Checkin dialog.
  • Agent Transfer nodes (only at the end of the conversation). For example, for a Money Transfer task, you might want to authenticate the user credentials via a live agent.
  • add Digital Forms for capturing series of user inputs. For example, for a Create Account task, you might want to present a form to capture the user details like name, address, phone number, etc.

Configurations

While building the conversation, the nodes are generated with default settings. You can customize these configurations from the conversation builder itself or do it at a later time from the dialog task.
In the following section, we see the various configurations available from the conversation builder for each node added.

Entity Node

The entity node is created whenever Bot -> Ask Question is selected.
For each question you can:

  • define Entity Type – select from the drop-down list. This list includes the entity types supported by the Kore.ai platform.
  • apply Formatting Options like bold, italics, etc.
  • use Templates like buttons, carousel, etc to present the query

Once added you can configure properties:

  • Display name,
  • Node name,
  • Type,
  • Is Multi-Item,
  • User Prompts, and
  • Error Prompts.

Refer here for details on Entity component properties.

Confirmation Node

The confirmation node is created whenever Bot -> Ask Confirmation is selected, along with a Yes, No, and two other user response paths. You can delete or add more options.
For each confirmation you can:

  • apply Formatting Options like bold, italics, etc.
  • use Templates like buttons, carousel, etc to present the confirmation options
  • You can set configuration properties like
  • Select the concerned user response options to continue with the appropriate path

Advanced Features

Apart from the linear flow, you can add exceptional flows to the conversation. For example, while in the Book Flight task user might request the Weather Report at the destination city, or while in the Check Balance task, the user might have entered the wrong account number three times in a row. These exceptional cases can be taken into consideration as a part of the conversation builder.

For each user response you can specify:

  • Alternative User Response can trigger a different flow. For example, at the prompt for City entity for the Weather Report task, the user says “Not now” then the conversation should end.
  • Bot response when User Exceeds Retries limit.
  • Bot behavior with an interruption or a sub-intent is indicated with Ask Another Intent. For example, within the Book Flight task, the user asks for the Weather Report at the destination city using the specific intent.

Alternative User Response

This option lets you define the bot behavior when a user responds in a specific but unrelated manner.

Exceeds Retries

This option lets you define the bot behavior when a user exceeds the set number of retries.

  • A standard response is set by default
  • Use Configure Properties to define the settings like number of Allowed Retries and the Behavior on exceeding retriesend of dialog or transition to a node

Ask Another Intent

This option lets you define the bot behavior when a user utterance deviates from the task at hand.

  • Enter the user response that is likely to ask for another intent.
  • You can choose the intent from the available list or create a new one
  • You can set the transition to the new intent:
    • as Interruption to allow the user can switch to another task, you can configure additional utterances, refer here for more on interruption handling, or
    • as Sub-intent to allow the user to seamlessly branch into related intents, view the behavior, see here for more on sub-intent