Variable collections

Inputs are ways to store data collections to be used during Experiments.

Inputs, also known as {{variables}}, are designed to keep your prompt dynamic.

Example prompt: Summarize the {{transcript}}.

Storing your input collections can be helpful when using the same inputs multiple times. Common use cases are: regression testing and back testing.

Inputs can also be used to validate configuration changes on an existing model. Re-testing a model with previously used inputs can ensure that behaviors stay consistent with expectations.

To promote reusability, inputs can be created at the workspace level and imported during any Experiment.

Creating a new Input Collection

To create a new Input collection, head to your panel and select the Resources > Inputs tab.

Start by selecting Create Collection at the top right of the screen. After entering a name and a project, you will be redirected to the following screen.

Preparing a .csv file for import

To create an input collection, you need a .csv file containing your inputs.

Here we will be working with the following sample file, containing two columns, call_id and transcript.

🚧

The delimiter for your .csv file must be ,.

Do not use a trailing delimiter

Importing a .csv file

To add this file to your collection, select Import, then drag-and-drop your .csv file into the modal.

Once your file is uploaded, you will be able to double check the columns loaded in your inputs.

Once imported, you can review and edit all inputs within the collection:

Using an Input Collection in an Experiment

Within an Experiment, head to the Inputs tab and select Import then Import from inputs collection.

You'll then see the following modal where you can select a previously created input collection.

📘

Once imported you can use the collection within your experiment, to learn more, see Running an Experiment.