> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ottic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute test runs

> Run tests and see results

A `Test Run` determines which test cases will be tested.

In a test run, you can either include all your project's test cases or select a subset of them to be tested.

## Configuring a test run

To create a  test run menu:

* Click the " New Test Run";
  <img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_create.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=8239d2cc47294cd4d7e00255d4759ec2" alt="Test case" width="1200" height="750" data-path="images/run_create.png" />
* Name the test run;
* Choose which test cases will be tested;
* Click "Start test run" to execute the tests.

  <img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_select.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=ddde27e0957ab6a9c72957f2ed368d5c" alt="Test case" width="2880" height="1800" data-path="images/run_select.png" />

<Note>
  The test may take a few seconds to process before displaying the results.
</Note>

## Viewing overall test results

On the Test Run List screen, you can monitor the following details for each test run:

* Overal results of the test run;
* Breakdown of results (which test cases passed and failed);
* Date of execution.

<img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_view.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=3a1c9efa5e78300443dd7a9392d59ef6" alt="Test case" width="1200" height="750" data-path="images/run_view.png" />

There are the following status:

| Status        | Description                                        |
| ------------- | -------------------------------------------------- |
| `Passed`      | The test completed successfully.                   |
| `Failed`      | The test did not meet the expected results.        |
| `Error`       | An error occurred, and the test was not processed. |
| `In progress` | The test is currently running.                     |

<Note>
  The test may take a few seconds to process before displaying the results.
</Note>

## Exploring details of test results

Open an individual test case to view detailed information.

In the **Execution** tab you´ll see:

* Title and ID of the test case;
* Date and time of execution;
* Test status (passed, failed, error, in progress);
* Input or conversation tested;
* Expected output for the test case;
* Reasoning explaining why a test case failed.
  <img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_item.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=0ea59304632ec3c3e50118ed3e513f81" alt="Test case" width="1200" height="750" data-path="images/run_item.png" />

In the **Run History** tab, you´ll see:

* When it was executed (Date and time);
* Test runs it is associated with (ID and title of the Run);
* Results history (passed of failed)

<img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_history.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=5e9848258189ef10d96661f5cf998d37" alt="Test case" width="1200" height="750" data-path="images/run_history.png" />

<Warning>Once a test has been run, its status is locked and cannot be modified.</Warning>

## Duplicating and running a test

If you need to re-run the same test, simply click "Duplicate and Run.

<img src="https://mintcdn.com/ottic-65/nojWNBWtNbQT6cbM/images/run_duplicate.png?fit=max&auto=format&n=nojWNBWtNbQT6cbM&q=85&s=58a029b1bf2ff9255ac632431c900c86" alt="Test case" width="1200" height="750" data-path="images/run_duplicate.png" />
