Skip to main content

Agents draft and version

The Agent draft and version features allows you to safely develop and improve your agent without affecting the live version. Work on your agent in a draft with auto-save, then save your changes when you are ready, use version history to restore to a previous state.

Understanding drafts, published versions, and history

The following states enable safe iteration in drafts, confident go‑lives through publishing, and reliable fallback using history:

  • Draft: A work‑in‑progress where you can experiment and prepare changes. You can save or discard the draft if you no longer need the changes.
  • Published: The live copy end users are actively using. When you save a draft, it replaces the current published version.
  • History: In history, you can view the saved versions and restore one of the versions as a new draft. The system retains up to 30 saved versions, identified by timestamp and editor metadata. The older entries are view‑only. To use one, you can restore it as a new draft and save when ready.

Working with drafts and publishing

With the draft and version feature in agents, you can do the following:

  • Save: You can save the current draft to become the new live version.
  • Discard: You can discard a draft if you no longer need the changes.
  • Restore: You can restore from history by selecting a past entry and creating a new draft from it.

NOTE: Changes made to the drafts are saved automatically.

Drafts in the Agent Library

  • Agent drafts are saved automatically.
  • Use the Drafts filter to view the agents that currently have active drafts.
  • Owners, editors, moderators see draft tags only on agents they can edit.
  • View‑only users can not see draft tags.

Editing a draft

  1. Use the Drafts filter to view the agents that currently have active drafts.
  2. To edit a draft, select it from the list and hover over the draft to see the Edit draft button.
  3. Click Edit draft (pen icon).

NOTE:

  • Changes to agent permissions, sharing settings and publishing options are not versioned.
  • Only the changes to the core agent workflow are versioned.