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

# Agent Version Management

> Create, edit, and promote agent versions safely

## Overview

Agent versions allow controlled evolution of behavior without breaking existing integrations.

```mermaid theme={null}
graph LR
    A[Current Default Version] --> B[Create + Version]
    B --> C[Test and Validate]
    C --> D[Set as Default]
    D --> E[Monitor and Iterate]
```

## Version Workflow

1. Open an agent detail page.
2. Navigate to **Versions**.
3. Review **Current Version** and **Previous Versions**.
4. Click **+ Version** to clone baseline context.
5. Edit prompt/settings/deployment mapping.
6. Save and optionally promote default version.

<img src="https://mintcdn.com/budecosystem-b7b14df4/NacOxzTJ372ff60E/images/image-66.png?fit=max&auto=format&n=NacOxzTJ372ff60E&q=85&s=3c305df6070bdc7ed4eafa77ad9e4239" alt="Image" width="1920" height="877" data-path="images/image-66.png" />

## Best Practices