Skip to Content

Managing Agent Versions

Agent versions (revisions) help you manage changes safely. A revision captures the agent configuration at a point in time so you can deploy, compare, or roll back without guessing what changed.

Why revisions matter

Revisions let you:

  • Keep Draft changes separate from live behavior.
  • Track updates to responses, workflows, and settings.
  • Roll back quickly if something goes wrong.

Creating a revision

Open the Deploy page for your agent.

Deploy page

Click Deploy in the top-right corner.

Deploy button

Add a short description of what changed, then choose whether to deploy the revision immediately or create it as a Draft.

Create revision dialog

You will then see the revision in the list.

Revisions list

Changing the live revision

To change what is live, click the Deploy (rocket) button next to a revision. This lets you deploy a new version or roll back to a previous one.

Deploy revision button

Confirm the deployment to update the live revision.

Confirm deployment Updated live revision

Tips

  • Add clear descriptions so teammates understand what changed.
  • Test Draft revisions before deploying.
  • Keep a rollback plan for major updates.
Last updated on