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

# Manage Datasets

> Learn how to manage datasets

export const MaximPlayer = ({url}) => {
  return <iframe className="border-background-highlight-secondary h-full w-full rounded-md border-2 aspect-video" src={url} allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe>;
};

## Use Splits for Targeted Testing

Splits let you isolate specific rows from a dataset for targeted testing. Here's how to use them:

<Steps>
  <Step title="Create a Split">
    In your Dataset, select the rows you want to include in a split. Click the `Add x entries to split` button that appears.

    <img src="https://mintcdn.com/maximai/WBc78yGEmhfMYEOc/images/docs/library/how-to/datasets/use-splits-within-a-dataset/select-rows-and-create-split.png?fit=max&auto=format&n=WBc78yGEmhfMYEOc&q=85&s=a511b3b79fa5d5c3df19c7db43582642" alt="Select rows and create a split" width="2843" height="1701" data-path="images/docs/library/how-to/datasets/use-splits-within-a-dataset/select-rows-and-create-split.png" />
  </Step>

  <Step title="Use Split in Testing">
    Attach your split to a test run for evaluation:

    <img src="https://mintcdn.com/maximai/WBc78yGEmhfMYEOc/images/docs/library/how-to/datasets/use-splits-within-a-dataset/split-test-config-form-selection.png?fit=max&auto=format&n=WBc78yGEmhfMYEOc&q=85&s=4dd9619926f956fdb76212a75fb87557" alt="Configure test with split" width="2963" height="1830" data-path="images/docs/library/how-to/datasets/use-splits-within-a-dataset/split-test-config-form-selection.png" />

    <Note>
      Splits function just like Datasets across the platform and can be used with Prompts, Workflows, and other testing features.
    </Note>
  </Step>
</Steps>

## Use Variable Columns

Maxim provides a way to insert dynamic values into your entities at runtime via your Datasets in the form of variables. A variable is a collection of a key and a value.

You can refer to variables using the Jinja template syntax (double curly braces) `{{variable_name}}`.

You can populate variable values in various ways:

* Dataset column
* Use a context source to retrieve it at runtime

<Note>
  Maxim has specific types of reserved columns that take priority over the variables you've defined. These columns include:

  * input
  * expectedOutput
  * output
  * expectedToolCalls
  * scenario
  * expectedSteps
</Note>

<Steps>
  <Step title="Add Variables to Your Prompt">
    You can use variables in your Prompt to refer to dynamic values at runtime.
    For example, if you're creating a Prompt and want to provide context to the model, you can refer to the context via a variable in your system prompt:

    ```plaintext theme={null}
    You are a helpful assistant, answer a given answer with respect, be nice and respectful

    You may use {{context}} to answer the questions
    ```

    If you're using the Prompt playground, you can add variables via static values on the right side of the interface.

    Alternatively, if you're using it in a test run, you can create a context-named variable in your dataset. When the test run executes, this variable will be replaced with the values from your dataset column.

    <Note>
      You can use variables for Prompt Comparison and No-code Agent in the same way as you do in your Prompt playground
    </Note>

    <img src="https://mintcdn.com/maximai/5erI5VqjDLLSmvnr/images/docs/library/how-to/datasets/variables-usage/variable-usage-in-prompt-playground.png?fit=max&auto=format&n=5erI5VqjDLLSmvnr&q=85&s=275ddba73cc82a71b459330ab02cef63" alt="Variable usage in Prompt" width="2890" height="1746" data-path="images/docs/library/how-to/datasets/variables-usage/variable-usage-in-prompt-playground.png" />
  </Step>

  <Step title="Variable Usage in API Workflow">
    If you're using an API Workflow, you can add variables to your workflow body, headers, or query parameters in the same way.

    <img src="https://mintcdn.com/maximai/5erI5VqjDLLSmvnr/images/docs/library/how-to/datasets/variables-usage/variable-usage-in-workflow.png?fit=max&auto=format&n=5erI5VqjDLLSmvnr&q=85&s=23d6c883eed3e92547cfe4b0bb3a2b65" alt="Variable usage in Workflow" width="2890" height="1746" data-path="images/docs/library/how-to/datasets/variables-usage/variable-usage-in-workflow.png" />
  </Step>

  <Step title="Variable Usage in Evaluators">
    You can use variables in your custom evaluators in the same way as you do in your Prompts. This allows you to provide additional context to your evaluators for better results.

    <img src="https://mintcdn.com/maximai/WBc78yGEmhfMYEOc/images/docs/library/how-to/datasets/variables-usage/variable-usage-in-evaluators.png?fit=max&auto=format&n=WBc78yGEmhfMYEOc&q=85&s=0a11f5431a62ab7d2a66808d8de3ac32" alt="Variable usage in Evaluators" width="2890" height="1746" data-path="images/docs/library/how-to/datasets/variables-usage/variable-usage-in-evaluators.png" />
  </Step>
</Steps>
