Skip to content

Version Control

Track, manage, and restore previous versions of your AI agents.

Overview

Version Control allows you to maintain a complete history of changes to your agents, enabling you to: - Track what changed and when - Revert to previous versions - Compare different versions - Audit agent modifications

Accessing Version History

  1. Navigate to MY AGENTS
  2. Select your agent
  3. Click Version History from the agent menu

Version History View

Each version entry shows: - Version Number: Auto-incremented (v1, v2, v3, etc.) - Timestamp: When the version was created - Modified By: User who made the changes - Change Summary: Description of what changed - Status: Current, Previous, or Archived

Creating New Versions

Versions are automatically created when you: - Save changes to agent configuration - Update instructions or prompts - Modify model settings - Change tool configurations

Manual Version Creation

You can also create versions manually:

  1. Click Create Version button
  2. Add a description (e.g., "Pre-launch configuration")
  3. Click Save

Use manual versions for: - Before major changes - Release milestones - Backup points before testing

Comparing Versions

Compare two versions to see exactly what changed:

  1. Select two versions from the list
  2. Click Compare
  3. View side-by-side comparison

Comparison shows: - Added content (green highlight) - Removed content (red highlight) - Modified sections (yellow highlight) - Unchanged sections (no highlight)

Restoring Previous Versions

Option 1: Restore as New Version

  1. Find the version you want to restore
  2. Click Restore
  3. Review the configuration
  4. Click Save as New Version

This creates a new version based on the old configuration, preserving history.

Option 2: Rollback (Overwrites Current)

Destructive Action

Rollback permanently replaces the current version. Use with caution.

  1. Find the version to restore
  2. Click Rollback
  3. Confirm the action
  4. Current version is replaced

Version Naming & Tagging

Automatic Versioning

  • Format: v1.0, v1.1, v1.2, v2.0
  • Major version: Significant changes (instructions, models)
  • Minor version: Small tweaks (prompts, settings)

Tags

Add tags to important versions: - production - staging - pre-launch - backup

To add a tag: 1. Click on a version 2. Click Add Tag 3. Enter tag name 4. Save

Best Practices

Regular Checkpoints

Create manual versions before: - Major configuration changes - Production deployments - Testing new features - Model upgrades

Descriptive Change Summaries

Always add clear descriptions: - ✅ "Updated instructions to handle refund requests" - ✅ "Switched to GPT-4 for better reasoning" - ❌ "Changed some stuff" - ❌ "Update"

Version Cleanup

  • Archive old versions after 90 days
  • Keep tagged versions (production, milestones)
  • Delete unnecessary test versions

Testing After Restore

Always test agents thoroughly after restoring a previous version: - Verify tool connections - Test with sample queries - Check model availability - Validate knowledge base access

Version Metadata

Each version stores: - Configuration Snapshot: Complete agent settings at that point - Instructions: Agent behavior and prompts - Model Settings: Selected models and parameters - Tools: Connected integrations - User Info: Who created the version - Timestamp: Exact creation date/time

Troubleshooting

Version Restore Failed

Issue: Cannot restore a previous version

Possible Causes: - Model no longer available - Tool integration deprecated - Workspace permissions changed

Solution: - Review error message for specific issues - Update model selection if needed - Reconfigure tools with current settings - Contact support if issue persists

Missing Version History

Issue: Version history is empty or incomplete

Possible Causes: - Agent was recently created (only current version exists) - History was archived - Workspace migration

Solution: - Check if agent is newly created - Look in archived versions - Contact workspace admin

Version Retention Policy

Default Retention: - Last 30 versions: Kept indefinitely - Older versions: Archived after 90 days - Tagged versions: Never auto-archived

Custom Retention (Enterprise): - Configure custom retention periods - Adjust auto-archive rules - Set compliance requirements