# Versions

## What is a version?

A version is a specific **configuration** of an agent.

WorkflowAI defines two types of (agent) versions:

| Version Type       | Example            | Description                                                                                                                                |
| ------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Major** Versions | 1, 2, 3, ...       | A major version represents a specific configuration of a agent, including its instructions, temperature, descriptions/examples, and tools. |
| **Minor** Versions | 1.1, 1.2, 1.3, ... | A minor version represents a major version **associated with a specific model** (e.g., OpenAI's GPT-4o-mini).                              |

![Version 2 is a major version, version 2.1 is version 2 running on Gemini 2.0](https://2418444523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW4ng0K5LfFjYqHYuPgNh%2Fuploads%2Fgit-blob-dd71ee668a040738cd565059520b3f262e161694%2Fversions.png?alt=media)

## Why are versions useful?

Versions are useful for several reasons:

* They allow you to save a specific configuration of an agent, so you can reproduce it later.
* They allow you to [compare the performance of different versions of an agent](https://docs.workflowai.com/ai-features-playbook/evaluating-your-ai-feature).
* They allow you to [deploy a specific version of an agent](https://docs.workflowai.com/features/deployments).

## How to:

### Save a version

When using the playground, you can save a version by clicking on the "Save" button.

![Save a version](https://2418444523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW4ng0K5LfFjYqHYuPgNh%2Fuploads%2Fgit-blob-feb4d4bef0467b8d7bc262618d101c0ef9e6bd8e%2Fsave-version.png?alt=media)

Additionnaly, you can save all versions currently running by clicking on the "Save all versions" button.

![Save all versions](https://2418444523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW4ng0K5LfFjYqHYuPgNh%2Fuploads%2Fgit-blob-532117833f3902d81ded6dd642e61d96dd2b0796%2Fsave-all-versions.png?alt=media)

{% hint style="info" %}
You should save a version when you're satisfied with the LLM output and want to preserve the current configuration. A saved version captures your chosen model, prompt, temperature setting, and other parameters, allowing you to reliably reproduce these results later, or use them in a [deployment](https://github.com/WorkflowAI/documentation/blob/main/deployments/README.md).
{% endhint %}

### List all versions

You can access the list of all versions by clicking on the "Versions" section from the menu.

![List of all versions](https://2418444523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW4ng0K5LfFjYqHYuPgNh%2Fuploads%2Fgit-blob-db9ad237eaff4b24e0c07b7db0b9afc966f2d399%2Fversions-section-full.png?alt=media)

### Clone a version

Cloning a version is useful when you want to create a new version based on an existing version. For example, you have a version running on OpenAI's GPT-4o-mini, and you want to quickly reuse the same instructions, temperature, and tools for a new version running on Gemini 2.0.

{% embed url="<https://customer-turax1sz4f7wbpuv.cloudflarestream.com/be1801a4342a1352fa5aa9aa7f5da707/watch>" %}