# Scenarios

## What is a scenario?

A scenario in OpenDialog encompasses the set of functionalities that make up your AI application.

## Accessing the scenario overview

Each workspace holds one or more scenarios. You can access the Scenario overview through the left-hand panel menu, by selecting 'Scenarios' and then 'Overview'.

You can also do so by accessing the Scenario overview through the dedicated button 'Manage scenarios'.

<figure><img src="/files/G8cztfU3rPyyeBcxw4gY" alt=""><figcaption><p>Access the scenario overview through the left-hand menu or via the Manage Scenarios button.</p></figcaption></figure>

{% hint style="info" %}
**Note**: If your workspace has no scenarios yet, the Workspace Dashboard will indicate 0 scenarios, and the button will say 'Create scenario.' Clicking the 'Create scenario' button will allow you to create your first scenario. More on [creating new scenarios](#creating-a-new-scenario) below.
{% endhint %}

## Creating a new scenario

Create a new scenario using the main area's 'Create Scenario' button.

<figure><img src="/files/uBu99uGZWnavX8l3xJE9" alt=""><figcaption><p>Create a new scenario via the 'Create new scenario' button or import an existing scenario via a .json file</p></figcaption></figure>

Scenarios are by default, created in draft mode. To use in a live environment, set the scenario to active by toggling the switch in the bottom right corner of the scenario tile (example shown in top left corner of scenario list), and [publish](/opendialog-platform/launching-your-application.md) it.

## Duplicating, deleting and exporting a scenario

Click the vertical dots icon in the top right corner of a scenario tile to access the duplicate, delete and export functionality.

When duplicating a scenario the duplicated scenario will be added to the workspace as the last one in the list. You may have to refresh your browser for it to display.

When you export a scenario, an email is sent to your registered email address in OpenDialog. The scenario is contained in an attached .json file, which can then be imported into another workspace.

Duplicating and exporting may take a few minutes; you will be emailed when the resulting file is ready.

<figure><img src="/files/vNbNapeR24CkCACaa9F1" alt=""><figcaption><p>Example of Scenario functionality</p></figcaption></figure>

## Importing a scenario

To import a scenario, you will need access to a .json file that you will upload during import. For example, you may have received a .json file as an export from another workspace or as an email attachment.

<figure><img src="/files/vo6trrImKzpsFAzh8boS" alt=""><figcaption><p>Import scenario option at the top of the main Scenario Overview area.</p></figcaption></figure>

Use the Import Scenario button at the top of the main area and provide the .json file. Note that there is a 10 Mb file size limit on scenario .json files.

## Active and draft 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.

## Scenario settings

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. Setting a condition on a scenario is relevant in a multi-agent architecture, where conditions on scenarios identify a scenario for consideration.

<figure><img src="/files/9KjvRx9Oepn8fVRL5ix8" alt=""><figcaption><p>Scenario settings in the conversation designer</p></figcaption></figure>

## How to design your scenario

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="/pages/HoT4icsv4cXf0maTuCO8"><strong>The OpenDialog model</strong></a></td><td>Take a deepdive into the underpinning model for OpenDialog applications.</td><td></td><td><a href="/pages/HoT4icsv4cXf0maTuCO8">/pages/HoT4icsv4cXf0maTuCO8</a></td><td><a href="/files/XI9UDgAESlby0yU6Z36i">/files/XI9UDgAESlby0yU6Z36i</a></td></tr><tr><td><a href="/pages/MJprpdwMUMWCWgGCedL0"><strong>Designing your application</strong></a></td><td>Create a new scenario from a template or from scratch using OpenDialog's model and best practices.</td><td></td><td><a href="/pages/MJprpdwMUMWCWgGCedL0">/pages/MJprpdwMUMWCWgGCedL0</a></td><td><a href="/files/LQ12uWCtnqEKQyZZQb8g">/files/LQ12uWCtnqEKQyZZQb8g</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opendialog.ai/core-concepts/the-opendialog-workspace/scenarios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
