> For the complete documentation index, see [llms.txt](https://docs.foretellreality.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foretellreality.com/foretell-ai/authoring-tool/scenario.md). # Scenario The scenario tab is where the author defines the basic details of a simulation: where it takes place, what information is given to the trainee before they start, and what documents will be referenced during the simulation. ## Environments Foretell has provided a list of environments where conversations may take place. Each simulation must use at least one Environment, but you can choose multiple environments as options.
When the Learner starts the AIA Simulation, they'll be able to choose the environment from the set of options you select here, with the default environment being the first one in the list. You can reorder the selected environments using the arrows underneath them. ## Settings
### Allow Interpersonal Simulation The **"Allow interpersonal simulation"** toggle allows this simulation to be used without AI, instead letting two users use the Foretell Social meeting system to practice roleplaying the scenario together. For more information on setting up this kind of meeting, go to this page: [Interpersonal Simulation](/foretell-ai/authoring-tool/scenario/interpersonal-simulation.md) ### Require User Document Upload The **"Require user document upload when starting a simulation"** toggle makes it so that a Learner has to upload a document to the simulation before they can begin. An example of when this might be used is for job interview training, where a Learner might upload their resume for the AI agent to reference. Clicking that toggle will add a new section called **"User Upload Required Documents"**. Each required document must have a Title, and you can add an optional description for the document. You can add a new required document by clicking on the **"+ Add Required Document"** button, and you can delete a required document by clicking on the button to the left of the document that looks like a trash can. You can also adjust the order of the documents using the up and down arrows to the right of the document titles.
From the perspective of the Learner, when they try to start the simulation a window will pop up asking them to upload documents. After they click the **"Upload Documents"** button and select the document, a summary of their document will appear under the **"Created and/or Uploaded Documents"** section which they can review and edit if they wish. Once they are ready, they can click on the **"Continue"** button in the bottom right corner of the window to begin the simulation.
### Upload Image If you wish to upload an image to use as the thumbnail for your AI simulation when it is used for Assignments you can click on the **"Browse"** button under the "Upload Image" section. This will open your File Explorer where you can find and select an image file.
When a Learner sees this simulation for one of their assignments this image will show up when they select the assignment.
## Details The Scenario Details are the primary way for the Author to provide Learners with the context needed for the conversation, such as why the conversation is happening, what events or information may be referenced, as well as what the Learner's goals may be. To create a Scenario Detail, click on the black button labeled **"+ Add Scenario Detail"**. This will create a new Scenario Detail slot with a box for defining the name of the detail and a box for the contents of the detail. You can edit the name and contents boxes by clicking on them, editing them, and then either pressing the "Enter" key or clicking on the **"Save"** button. To delete a Scenario Detail click on the red minus button at the far right of the Scenario Detail.
When anybody runs this simulation, the Scenario Details will be the first thing they see.
## Supporting Documents Supporting Documents are a way to provide reference files for the AI agent to use during conversation. In addition to the AI persona details we type in, we can provide documents such as a pdf of the company's employee handbook, a resume, or a witness statement. There are two places to submit Supporting Documents. Supporting Documents uploaded to the Scenario tab will be used for all AI Personas, while Supporting Documents uploaded to the AI Persona tab will only be used when that AI Persona is used. To upload a document, click on the button labeled **"Upload Supporting Document(s)"**. This will open a File Explorer window where you can search for and select the file you wish to upload. These files must be text based. After uploading, the contents of the document will be added to a new slot in the **"Created and/or Uploaded Supporting Documents"** section. You can edit the name and contents of the upload after the fact by clicking on the text boxes, making your changes, then clicking the **"Save"** button at the bottom of the page.
There is a limit of 16383 characters for each document. If you want, you can divide larger documents into multiple Supporting Documents. There are 5 total document slots available for each scenario. If you do not have a file to upload and wish to simply type in a supporting document, you can use the **"+ Add Supporting Document"** button. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.foretellreality.com/foretell-ai/authoring-tool/scenario.md?ask= ``` 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.