Skip to main content
Use environments to test agent changes before they reach live callers. Without a deployment pipeline, every edit goes straight to production — meaning a broken prompt or misconfigured flow affects real calls immediately.
New to environments? Start with the Environments tutorial for a hands-on introduction. For detailed workflows and best practices, see Version management.
Saving is not the same as going live. When you save changes in Agent Studio, they exist only as a draft. Drafts must be published to create a version in Sandbox, then promoted through Pre-release to Live before they affect real callers. If you save and don’t publish, your changes won’t appear in any environment. If you publish but don’t promote, changes stay in Sandbox only.
Develop, test, and deploy through environments: Draft → Sandbox → Pre-release → Live.

​
Creating a version

A version is created whenever changes are made to an agent. A draft banner appears at the top of the page, allowing you to:
  • Delete: Revert to the most recent published version.
  • Publish: Save the draft as a version, optionally adding a description highlighting changes made and any notes for future collaborators.
delete-publish Once published, the version becomes your active deployment and you can access it from Deployments > Environments in the sidebar. active-publish

​
Promoting a version

Promotion moves a version from one environment to the next. The environments include Sandbox, , and .

​
Pre-release

Pre-release is used for user acceptance testing (UAT). It is a stable staging area where versions are tested before being released to production.
  1. Go to Deployments > Environments in the sidebar.
  2. Click the Options Menu next to the desired version.
  3. Select Promote to Pre-release.

​
Live

The live environment, also referred to as production, is where your agent handles real traffic. Changes promoted to Live affect all active calls immediately. Test thoroughly in Sandbox and Pre-release before promoting.
  1. Go to the Pre-release tab in Deployments > Environments.
  2. Click the overflow menu (three vertical dots) next to the version.
  3. Select Promote to Live.
  4. Confirm your selection by checking the box and clicking Promote.
initiate release

​
Comparing versions and environments

Before promoting changes, you can compare versions across environments using a side-by-side diff view.
  1. Go to the Deployments section and open Environments or Project History.
  2. Select a version and click Compare to view differences between Sandbox, Pre-release, and Live.
  3. Versions appear in reverse chronological order (newest first) for easier navigation.
For detailed information on tracking changes between versions, see Tracking changes.

​
Rolling back to a previous version

If an issue arises with the promoted version, you can roll back to a previous version:
  1. Go to Deployments > Environments in the sidebar.
  2. Select the Options Menu for the desired version.
  3. Click Rollback.
  4. Confirm the rollback.
Once complete, the system will notify you that the rollback was successful.
initiate rollback

​
Testing your agent

Main page: agent Chat You can test your agent by interacting with it in different environments. This helps identify issues and refine prompts.
  1. Click the Play Chat icon in the top-right corner of the screen.
  2. Select the environment containing the version you want to test.

​
Assigning phone numbers

Each environment can have a unique phone number, allowing you to distinguish between test calls and live calls. To assign phone numbers:
  1. Go to Configure > Numbers in the sidebar.
You can assign different phone numbers and SIP headers to your versions here. assign version phone numbers

Compare versions

Side-by-side diff of any two versions before promoting.

Project history

Audit trail of all published versions and changes.

Test suite

Run regression tests against Draft or Sandbox.
Last modified on March 29, 2026