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

# How to Run LLM Prompt Experiments

> Run experiments with historical datasets to test, evaluate, and improve prompts over time while preventing regressions in production systems.

<Warning>
  We are deprecating the Experiments feature and it will be removed from the platform on September 1st, 2025.
</Warning>

## Feature Highlight

* Create as many prompt versions as you like, without impacting production data.
* Evaluate the outputs of your new prompt (and have data to back you up 📈).
* Save cost by testing on specific datasets and making fewer calls to providers like OpenAI. 🤑

## Running your first prompt experiment

To start an experiment, first, go to the [Prompts](https://www.helicone.ai/prompts) tab and select a prompt.

<Steps>
  <Step title="Click `Start Experiment`">
    On the top right, click `Start Experiment`.

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/start-button.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=90d10ccc33b5804d4c9b9b49ca11a8d2" alt="Start button in the Prompts tab for initiating an experiment in Helicone." width="1868" height="1118" data-path="images/use-cases/experiments/start-button.png" />
    </Frame>
  </Step>

  <Step title="Select the base prompt">
    Select a base prompt and click `Continue`. You can edit the prompt in the
    next step.

    <Tip>
      To run an experiment on the production prompt, look for the `production`
      tag.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/select-prompt.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=a718822d2d0b683bc66debb59e987956" alt="Selecting a base prompt to start an experiment in Helicone." width="1868" height="1118" data-path="images/use-cases/experiments/select-prompt.png" />
    </Frame>
  </Step>

  <Step title="Edit the prompt">
    Your changes will not affect the original prompt, but rather create a new
    one to test your experiment on.

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/edit-prompt.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=414269aee59b5f71d4fce5d79e162643" alt="Editing a prompt without affecting the original prompt in production." width="1868" height="1118" data-path="images/use-cases/experiments/edit-prompt.png" />
    </Frame>
  </Step>

  <Step title="Configure your experiment">
    Select the dataset, model and provider keys.

    <Tip>
      To run your experiment on a random dataset, click `Generate random
                  dataset`. We will pick up to 10 random data from your existing
      requests.{" "}
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/config.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=9c29a431ac8983fc4ecd02af63e564eb" alt="Configuring an experiment with a different dataset, model, and provider keys in Helicone." width="1868" height="1118" data-path="images/use-cases/experiments/config.png" />
    </Frame>
  </Step>

  <Step title="Confirm and run">
    The `Diff Viewer` compares your new prompt to the base prompt that you
    selected.

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/confirm.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=65128f6b3edb078773780d64c80b3e76" alt="Confirming changes to your prompt in Helicone's Diff Viewer before running an experiment. " width="1868" height="1118" data-path="images/use-cases/experiments/confirm.png" />
    </Frame>
  </Step>

  <Step title="View outputs">
    Once the experiment is finished, click on it to see a list of inputs and the
    associated outputs from the base prompt and the experiment.

    <Frame>
      <img src="https://mintcdn.com/helicone/WIDUeIzURs2yWBd-/images/use-cases/experiments/view.png?fit=max&auto=format&n=WIDUeIzURs2yWBd-&q=85&s=f451f518b2f4a0e5ddcc0f19c4a3ae3a" alt="Comparing the outputs of an experiment compared to the original prompt in Helicone." width="1868" height="1118" data-path="images/use-cases/experiments/view.png" />
    </Frame>
  </Step>
</Steps>
