Skip to main content

​
Overview

Agent versions create immutable snapshots of your agent’s configuration. When you make material changes, fork a new version to preserve a record of what changed and compare test results across versions.

​
When to create a version

Fork a new version when you change:
  • Call flow — conversation structure updates
  • Policy & guardrails — rule changes
  • LLM provider — switching the underlying model
  • STT provider — changing speech-to-text
  • TTS provider — changing text-to-speech

​
How to fork

  1. Go to Agent Settings
  2. Click New Version (or the version icon in the header)
  3. Select which change types apply to this version
  4. The current configuration is saved as an immutable snapshot
  5. You continue editing the agent — the snapshot preserves the previous state

​
Version history

View all versions of an agent in the Version History panel. Each version shows:
  • Version number
  • Change types (what was modified)
  • Creation timestamp
  • The configuration snapshot

​
Using versions with Ring 8

Versions pair naturally with Ring 8 (Temporal Stability). After forking a new version, run Ring 8 to compare the new version’s behavior against the previous baseline. This helps you catch unintended regressions from configuration changes.