Overview

Assign a percentage of incoming traffic to different environments to compare agent versions or roll out a change gradually.

Traffic split dialog with percentages for three environments
Allocate traffic across environments and deploy the split.

Individual users stay on the same environment across sessions so their experience is consistent.

When to use a traffic split

Use a traffic split when you want to measure a meaningful change before it reaches everyone, or compare two approaches head-to-head in production.

Use a traffic split when you want to measure a meaningful change before it reaches everyone, or compare two approaches head-to-head in production. For small, well-understood edits - copy tweaks, typos, minor prompt updates - you can simply edit Main and publish.

Once an environment has been validated as the winner, you should merge it back into Main rather than leave it running under a traffic split.

Use the Main environment as the source of truth for your agent. Once a change is ready - or an A/B test resolves in favour of the new environment - merge it back into Main, rather than leaving another environment serving 100% of traffic indefinitely.

Editing traffic split

Click Edit traffic split in the top right of Settings → Environments.

Click Edit traffic split in the top right of Settings → Environments. Add a row for each environment you want to include, set its percentage, and click Deploy. Percentages must add up to 100%. Removing an environment from the traffic split prevents users from automatically being routed to it but doesn’t remove the environment from your project.

When a traffic split is changed, the new settings will only be enforced for new sessions. Existing sessions will continue on their current environment.

Considerations

Users are automatically routed to an environment based on your specified traffic split.

  • Users are automatically routed to an environment based on your specified traffic split. You can’t pick specific users or cohorts to land on a particular environment. If you need cohort-based routing, pass a specific environment alias when your users connect (for example, in your chat widget snippet) instead of relying on this feature.
  • Traffic split applies to every way your users connect to your agent (chat widget, phone, API, custom clients). If you need different routing per channel, point each channel at a specific environment alias. Traffic split dialog with percentages for three environments

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.