Agent Versioning

Overview

Agent version management allows users to create, manage, and track different versions of an agent configuration in Agentic Studio. This feature helps maintain version history, compare changes, and roll back to previous configurations when required.

  1. To access the agent version, log in to the Agent Studio Console using the following URL:

    <https://tenant-url/admin#/genai/agents>

  2. Select the required Agent and Click Configure to open the Agent Configuration Page.
    Figure 1. Agent Dashboard
  3. After selecting Configure, the following page will be displayed. On the Agent Configuration page, the Version History and Save Version options are available at the top-right corner.
    Figure 2. Agent Configuration Page

Save Version

The Save Version option allows users to create a new version of an agent configuration.
  1. Select save version and enter the following details:
    • Version Name
    • Description
  2. Click Save.
    Figure 3. Save Version
  3. A new version of the agent configuration has been created and stored in Version History.
Validation
  • Duplicate Version Name:
    If the user enters an existing version name, the system will display a validation message indicating that the version name already exists.
    Figure 4.
  • Blank Version Name

    If the version name field is left blank, the system will display an error message prompting the user to enter a valid name.

Version History

The Version History feature allows users to view and manage all previously created versions of an agent.
Figure 5. Version History

Version History Dashboard

The Version History Dashboard displays all saved versions of the selected agent.
Figure 6. Version History Dashboard
Information Displayed:
  • Version Name
  • Description
  • Creation Date
  • Version Actions

Versions Tab

The Versions Tab lists all the available versions created for the agent.

Users can perform the following actions:
  • View version details
  • Preview a version
  • Rollback to a previous version
  • Compare versions

Version Details

The Version Details Page provides complete information about a selected version.
Figure 7. Version Details Page

Preview Version

The Preview option allows users to review the agent configuration before applying any changes.
Figure 8. Preview
On clicking Preview, the system displays the configuration of the selected version in read-only mode.
Figure 9. Configuration Preview Read-only mode

Rollback Version

The Rollback allows users to revert the agent configuration to a previous version.
Figure 10. Rollback
Clicking Rollback prompts the user to confirm the action.
Figure 11. Rollback Confirmation Message

Upon confirming the action by clicking Rollback again, the agent configuration reverts to the selected version.

Compare Versions

The Compare feature allows users to compare differences between two versions.

Select two versions and click Compare.
Figure 12. Compare
The system displays the differences between the selected versions.
Figure 13. Version Comaparison

Changelog

The Changelog tab records modifications made to the agent configuration.

Features:
  • Displays configuration updates
  • Shows change history
  • Provides timestamps for modifications
    Figure 14. Changelog

Changelog Tools

The following tools are available within the Changelog Tab:
Option Description
Search Allows users to search for specific changes
Filter

Filters change history based on criteria
Refresh Reloads the changelog data

Changelog Information Message

For agents created before changelog tracking was implemented, the system displays the following message:

"This agent was created before changelog tracking. Earlier history is unavailable."

This indicates that historical data prior to the implementation of changelog tracking cannot be retrieved.