Skip to main content

What is Version History?

Version History provides Git-like version control for your agent configurations. It allows you to track changes, review previous versions, rollback to earlier configurations, and manage multiple development branches.
Version History ensures you never lose your work and can always revert to a known-good configuration.

Accessing Version History

Version History is located in the right panel of the Advanced Editor. Click the “Git Changes” or “History” tab to access it.

Key Concepts

Versions

Each saved configuration is a version. Versions are numbered and timestamped:
PropertyDescription
Version NumberAuto-incrementing identifier (v1, v2, v3…)
TimestampWhen the version was created
Commit MessageDescription of changes
AuthorWho made the changes

Branches

Work on different variations of your agent simultaneously:
Branch TypeDescription
MainPrimary development branch
LiveProduction version (what customers experience)
CustomYour own feature or testing branches

Live Version

The “Live” version is what’s deployed to production. Only the Live version is used for actual customer calls.

Viewing Changes

Pending Changes

See what modifications haven’t been committed yet:
1

Open Changes Tab

Click the “Changes” tab in Version History.
2

Review Modifications

View a list of all unsaved changes.
3

Commit or Discard

Choose to save changes or revert them.

Change Details

Each pending change shows:
  • What was modified (greeting, prompt, settings, etc.)
  • Previous value
  • New value

Committing Changes

Save your changes as a new version:
1

Review Changes

Ensure all modifications are intentional.
2

Write Commit Message

Describe what you changed and why.
3

Commit

Click “Commit” to save the new version.

AI-Generated Commit Messages

Let AI suggest a commit message based on your changes:
  1. Click the ”✨ Generate” button
  2. Review the suggested message
  3. Edit if needed
  4. Commit
Good commit messages make it easier to understand what changed when reviewing history later.

Browsing History

View all previous versions:
1

Open History Tab

Click the “History” tab in Version History.
2

Browse Versions

Scroll through the list of all versions.
3

View Details

Click any version to see its details and changes.

Version Information

Each version entry shows:
FieldDescription
🔢 VersionVersion number
📅 DateWhen it was created
💬 MessageCommit message
🏷️ TagsLive, Latest, etc.

Restoring Versions

Rollback to a previous configuration:
1

Find the Version

Browse history to find the version you want.
2

Click Restore

Select “Restore” on the desired version.
3

Confirm

Confirm you want to restore this version.
4

Test

Test the restored configuration in Playground.
Restoring creates a new version with the old configuration. Your current changes will be preserved as a version in history.

Managing Branches

Creating a Branch

1

Open Branches Tab

Click the “Branches” tab in Version History.
2

Create New Branch

Click “New Branch” and enter a name.
3

Start Working

Switch to the new branch and make changes.

Switching Branches

  1. Open the Branches tab
  2. Click on the branch you want to use
  3. The editor loads that branch’s configuration

Deleting Branches

  1. Open the Branches tab
  2. Click the delete icon on the branch
  3. Confirm deletion
Deleted branches cannot be recovered. Ensure you’ve merged or saved any important changes.

Publishing to Live

Deploy your changes to production:
1

Ensure Changes are Committed

Commit any pending changes first.
2

Test in Playground

Validate your configuration works correctly.
3

Mark as Live

Click “Mark as Live” or “Publish” on the version.
4

Confirm

Confirm you want to deploy to production.
Only the Live version handles actual customer calls. Development versions don’t affect production.

Best Practices

Save versions frequently so you have more restore points.
Descriptive commit messages make history easier to navigate.
Create branches when testing major changes to avoid affecting your main configuration.
Always test in Playground before marking a version as Live.
Check what changed between versions before restoring an old one.

Common Workflows

Quick Fix

  1. Make change
  2. Test in Playground
  3. Commit with message
  4. Publish to Live

Major Update

  1. Create a new branch
  2. Make multiple changes
  3. Test thoroughly
  4. Merge to main
  5. Publish to Live

Rollback

  1. Identify the issue
  2. Find last working version
  3. Restore that version
  4. Publish to Live
  5. Debug the broken version

Next Steps