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

# Running Evaluations

> Execute evaluations on datasets or continuously on live production logs.

Once you have defined [evaluation criteria](/guides/evaluations/overview) (LLM-as-Judge, Programmatic Rules), you need to run them against your prompt's logs to generate results. Latitude supports two primary modes for running automated evaluations:

## Running Evaluations on Datasets (Batch Mode)

Batch evaluations allow you to assess prompt performance across a predefined set of inputs and expected outputs contained within a [Dataset](/guides/datasets/overview).

**Use Cases:**

* Testing prompt changes against a golden dataset (regression testing).
* Comparing different prompt versions (A/B testing) on the same inputs.
* Evaluating performance on specific edge cases or scenarios defined in the dataset.
* Generating scores for metrics that require ground truth (e.g., Exact Match, Semantic Similarity).

**How to Run:**

1. Ensure you have a [Dataset](/guides/datasets/overview) prepared with relevant inputs (and `expected_output` columns if needed by your evaluation metrics).

2. Navigate to the specific Evaluation you want to run (within your prompt's "Evaluations" tab).

3. Click the "Run experiment" button.
   <img src="https://mintcdn.com/latitudellms/Ssq9dzRdSVyjHEcj/assets/run-evaluation-experiment.png?fit=max&auto=format&n=Ssq9dzRdSVyjHEcj&q=85&s=eb3cc9f14b61002b067a41961eaa596a" alt="Open experiment modal" width="1046" height="272" data-path="assets/run-evaluation-experiment.png" />

4. Define the experiment variants

5. Select the Dataset you want to run the experiment against.
   <img src="https://mintcdn.com/latitudellms/Ssq9dzRdSVyjHEcj/assets/run-experiment.png?fit=max&auto=format&n=Ssq9dzRdSVyjHEcj&q=85&s=a2ff107feb0e16f88c69b4785c6afa9f" alt="Run experiment" width="1283" height="871" data-path="assets/run-experiment.png" />

6. You will be redirected to the experiments tab with the results
   <img src="https://mintcdn.com/latitudellms/NYIRJRDqJuCM5TjZ/assets/evaluation-experiment-result.png?fit=max&auto=format&n=NYIRJRDqJuCM5TjZ&q=85&s=7a277e758fd4aaa503d83f292639c9d4" alt="Evaluation experiment result" width="1020" height="901" data-path="assets/evaluation-experiment-result.png" />

## Running Evaluations Continuously (Live Mode)

Live evaluations automatically run on *new* logs as they are generated by your prompt in production (via API calls or the Playground). This provides continuous monitoring of prompt quality.

<img src="https://mintcdn.com/latitudellms/Ssq9dzRdSVyjHEcj/assets/playground_evaluations.png?fit=max&auto=format&n=Ssq9dzRdSVyjHEcj&q=85&s=abfa938b47a088741f8b8982cb244f4e" alt="Live Evaluation" width="665" height="683" data-path="assets/playground_evaluations.png" />

**Use Cases:**

* Real-time monitoring of key quality metrics (e.g., validity, safety, basic helpfulness).
* Quickly detecting performance regressions caused by model updates or unexpected inputs.
* Tracking overall prompt performance trends over time.

**How to Enable:**

1. Navigate to the specific Evaluation you want to run live.
2. Go to its settings.
3. Toggle the "Live Evaluation" option ON.
4. Save the settings.

<Note>
  Evaluations requiring an `expected_output` (like Exact Match, Lexical Overlap,
  Semantic or Numeric Similarity...), [Manual
  Evaluations](/guides/evaluations/humans-in-the-loop) or [Composite
  Evaluations](/guides/evaluations/composite-scores) **cannot** run in live
  mode, as they might need pre-existing ground truth or human input.
</Note>

## Viewing Evaluation Results

Whether run experiments or live mode, results are accessible:

* **Logs View**: Individual logs show scores/results from all applicable evaluations that have run on them.
  <img src="https://mintcdn.com/latitudellms/NYIRJRDqJuCM5TjZ/assets/logs-evaluation.png?fit=max&auto=format&n=NYIRJRDqJuCM5TjZ&q=85&s=e27f57acdc0291f7119ed57eb7f9cbc1" alt="Log with Evaluation Results" width="2716" height="1158" data-path="assets/logs-evaluation.png" />
* **Evaluations Tab (Per Prompt)**: View aggregated statistics, score distributions, success rates, and time-series trends for each specific evaluation.
  <img src="https://mintcdn.com/latitudellms/NYIRJRDqJuCM5TjZ/assets/evaluation-dashboard.png?fit=max&auto=format&n=NYIRJRDqJuCM5TjZ&q=85&s=352ef9020b6ce374e55be1a64dd9358d" alt="Evaluation Dashboard" width="1583" height="722" data-path="assets/evaluation-dashboard.png" />
* **Experiments**: When you run evaluations as experiments, you can view detailed results, compare different variants

These results provide the data needed to understand performance, identify issues, and drive improvements using [Prompt Suggestions](/guides/evaluations/prompt-suggestions).

## Next Steps

* Learn how to prepare data using [Datasets](/guides/datasets/overview)
* Understand how evaluation results power [Prompt Suggestions](/guides/evaluations/prompt-suggestions)
* Explore the different [Evaluation Types](/guides/evaluations/overview)
