> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.simchat.ai/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Creating scenarios using the AI scenario generator

The **AI scenario generator** turns a short description - or documents you already have - into a complete draft scenario. It fills in the instructions, script, checklist, questions and resources for you, and you edit anything you want before publishing.

It is a fast way to build a first draft, or to convert existing case notes, guidelines and job descriptions into practice conversations.

|| Open it from the sidebar's **Create scenario** button, then choose **Generate with AI**.
---

## Generating a scenario

**1. Choose an AI behaviour.** This is required, and it shapes the whole draft: how the avatar plays its role, how the conversation is marked, and the style of feedback. You can also select **Create new AI behaviour** if none of yours fit.

**2. Describe what you need.** Write a few sentences in the box. Say who the AI character is, what the situation is, and what the learner should practise. There is an **Examples** button with starting points you can adapt, and a **Dictate** button if you would rather speak than type.

**3. Add source material (optional).** Use **Attach files** to upload documents or images, or **Browse library** to pick files already in your [media library](https://support.simchat.ai/en/article/using-the-media-library-images-video-documents-and-accessibility-6d0htt/).

**4. Select Generate scenario.** The draft then opens in the scenario editor for you to review.
---

## What you can upload

* **Documents** - PDF, Word (`.docx`), PowerPoint (`.pptx`), text (`.txt`, `.md`)
* **Images** - JPG, PNG, GIF, WebP

Maximum file size is 200 MB. The older Word `.doc` format isn't supported, so save as `.docx` first.

Good source material includes clinical guidelines, case notes, job descriptions, policies, training handouts and lecture slides.
---

## Writing a good prompt

The more context you give, the closer the draft will be to what you want. Useful things to include:

* Who the AI character is, and their situation or emotional state
* What the learner is meant to practise or demonstrate
* The setting, and roughly how long the conversation should run
* Anything the character should hold back unless they are asked

A vague prompt produces a generic scenario. A specific one produces something you can almost use as it is.
---

## Reviewing the draft

The generator produces a starting point, not a finished scenario. Always read it through before it reaches learners. Check that:

* The **script** matches how you want the character to behave, and doesn't contain invented facts
* The **checklist** reflects what you actually want to mark
* The **instructions** give learners the right context
* The **questions** and **resources** are relevant

You then set the remaining details yourself in the editor: who can access the scenario, which conversation modes are available, the voice and video avatar, collections, tags and curriculum topics. See [Building a scenario step by step](https://support.simchat.ai/en/article/building-a-scenario-step-by-step-19irzen/).
---

## Publishing

Generated scenarios take exactly the same route as any other:

* **Owners, administrators and assistant administrators** select **Publish**
* **Cohort leads** publish scenarios aimed at the cohorts they staff
* **Authors** select **Submit**, and a reviewer approves it or sends it back

See [Submitting scenarios for review and publishing updates](https://support.simchat.ai/en/article/submitting-scenarios-for-review-and-publishing-updates-16nmp8t/).
---

## If the results aren't right

* **Too generic** - add more detail about the character, the setting, and what should go wrong in the conversation
* **Wrong tone or marking style** - try a different AI behaviour, or [create a custom one](https://support.simchat.ai/en/article/creating-custom-ai-behaviours-5wyoxu/)
* **Your documents seem to have been ignored** - check the file uploaded successfully and is a supported type, and refer to it in your description
* **A message about missing generation instructions** - the AI behaviour you picked has none, so the generator falls back to its defaults. An administrator can add generation instructions to that behaviour