Scenarios in OpenDialog
Have you read our 'Getting started with OpenDialog' section? If not, we would advise reading that before you dive into the content here as it gives an overview of the concepts behind OpenDialog.
At the center of the whole OpenDialog experience is the Conversation Designer. This is where you can start designing new scenarios and manage existing scenarios.
Scenarios can be in either an "Active" or in "Draft" mode.
Active scenarios are available to be used in chat interfaces, while draft scenarios are not considered.
Roadmap: We will be adding a host of additional support around scenario states to handle mode nuanced situations such as versioning of scenarios, previewing scenarios, etc.
Scenario settings are accessible through the individual menus of each scenario. You can edit the Scenario name, description, set a preferred interpreter (which will act as the default interpreter throughout the scenario) and also set conditions.
When you create a scenario a condition is automatically set (e.g.
user.selected_scenario...) that checks the user context to see if they have a selected scenario defined. If a condition is not present then the scenario will always be considered.
If you delete this condition you will have to provide a different way to select the scenario - something you should do with care unless you put in place other conditions for scenario selection
Deleting a scenario will currently completely remove the scenario and all its elements (including all underlying conversations, scenes, turns, intents and messages).
Roadmap: We are working on functionality such as archiving and undoing delete actions but for the time being deletion is permanent!
You can replicate a scenario by clicking on the copy icon within the designer.
Scenarios can be imported and exported through the user interface.
To export a scenario right click on the dropdown menu on a scenario card and select export.
Once export is finished you will receive an email with a .json file containing the entire scenario configuration. This includes all conversations, scenes, turns, intents, messages, actions, interpreters and other setup config.
To import a scenario click on the scenario import button on the workspace:
You can then upload the .json file you received from an export and import it.
Import always creates a new scenario for you. If a scenario with the same name exists we will not replace it but create a new one with an appropriate different name.
Scenario imports happen in the background and you will receive an email to notify you when an import has completed.
There is a limit of 10mb on scenario size .json files.
Please note that while you may see a scenario card show up in the interface, the import is only complete after you have received an email.