# Authoring Tool

The Authoring Tool is an approachable way for anyone to prompt an AI Avatar to behave in a certain manner during a roleplay simulation. The Authoring Tool is made so that creators can enter a description of the AI Avatar's role along with background details that affect how the avatar responds during the simulation.

Start off with a specific scenario that you have in mind, for example:

* a difficult conversation
* a sales negotiation
* an introduction to a new process

Then create a new simulation and fill out the information for the roleplay scenario.

## **To create a new AI Simulation:**

1. Log into the [web portal](https://ai.foretellreality.com/) using an [Author](/foretell-ai/welcome-to-foretell-ai/user-roles.md) account
2. In the top left corner, select the **"Library"** tab from the left sidebar to view a list of simulations your account has access to.

<figure><img src="/files/uNNKUZpfDE3g3lFSaIcR" alt=""><figcaption></figcaption></figure>

3. To add a new simulation, at the top of the list click the button with a plus icon in the middle

<figure><img src="/files/OCynZwfpfZfusiGym1gw" alt=""><figcaption></figcaption></figure>

4. The pop-up offers three options for creating a new simulation

   <figure><img src="/files/3C2buEqnGMhugb1YPbOR" alt=""><figcaption></figcaption></figure>

   1. Empty Simulation - Start from scratch and fill everything in yourself
   2. Guided Setup - Use our guided setup tool to get the basics of the simulation done quickly

      <figure><img src="/files/ZMjNlxnb1wybR9fOXFpa" alt=""><figcaption></figcaption></figure>
   3. AI Wizard - Tell our AI tool what simulation you want and let it create it for you

      <figure><img src="/files/3xggYozuGLGuxWj8rdPJ" alt=""><figcaption></figcaption></figure>
   4. Alternatively, to edit an existing simulation from the Simulation Library, find your simulation in the list and then click on the pencil "Edit" button to the left of the name of the simulation.

<figure><img src="/files/fI0QzAM9hDs21efycCxP" alt=""><figcaption></figcaption></figure>

5. There are 5 sections to each AI Simulation

* [Scenario](/foretell-ai/authoring-tool/scenario.md) - The location where the simulation will take place
* [AI Personas](/foretell-ai/authoring-tool/ai-personas.md) - The information that the AI agent uses to hold the conversation
* [Trainee Personas](/foretell-ai/authoring-tool/trainee-personas.md) - Information about the role the trainee is performing
* [Assessment Criteria](/foretell-ai/authoring-tool/assessment-criteria.md) - A rubric for how the trainee's performance will be evaluated immediately after the simulation is ended
* [Guardrails](/foretell-ai/authoring-tool/guardrails.md) - Toggles to tell the simulation to avoid specific topics or behaviors.

6. When editing the AI Simulation, you will typically start in "Simple Mode" where you can edit the basics of the simulation. However, to add greater detail many features require you to open up "Advanced Mode"
   1. Simple Mode - All sections are on one page with collapsible sections. However, the editing options are more limited.
   2. Advanced Mode - You can change between tabs at the top of the page and you have more control over the finer details of the simulation.

      <figure><img src="/files/1DGIfKsNMJj1r4ESST45" alt=""><figcaption></figcaption></figure>

7. For more information on sharing newly created simulations with Learners, go to this page: [Sharing and Distributing Simulations](/foretell-ai/authoring-tool/sharing-and-distributing-simulations.md)


---

# 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.foretellreality.com/foretell-ai/authoring-tool.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.