Skip to main content

Managing Prompt Versions in GPTfy

Overview​

Iterating on prompts is essential—but sometimes the latest version doesn't work as expected. GPTfy’s Prompt Versioning gives you the power to track, restore, and manage changes effortlessly. Whether you’re testing improvements or rolling back to a stable version, versioning ensures full control for your prompt engineers.

This guide covers:

  • Enabling Prompt Versioning
  • Creating and Managing Versions
  • Reinstating Previous Versions
  • Migrating Prompts Across Environments

alt text

Enabling Prompt Versioning​

To enable versioning:

  1. Go to Cockpit → AI Settings → Preferences
  2. Turn the Prompt Versioning toggle to ON

alt text

Note: New versions are created only if this setting is enabled.

Creating and Managing Prompt Versions​

Step 1: Create or Open a Prompt​

  • Navigate to Prompts from the Cockpit
  • Open an existing prompt or click New to create one

alt text

Step 2: Activate the Prompt​

  • After configuring the prompt, click Activate
  • A pop-up will appear: "What's new in this Prompt?"
  • Enter update details and click Continue

alt text

Important: Every activation creates a new version automatically.

Step 3: Modify the Prompt​

  • Deactivate the prompt before editing
  • Make your changes
  • Activate again to save as a new version

alt text

You can experiment with different prompt commands while keeping the same context mapping.

Reinstating Previous Versions​

alt text

To revert to a working version:

  1. Go to the Versions tab
  2. Find the version you want
  3. Click Reinstate

alt text

What Happens:​

  • The current active version is deactivated
  • A new version is created based on the reinstated version

Note: Your version history remains intact for future reference.

Migrating Prompts Across Environments​

alt text

Step 1: Download a Version​

  • Click the version number to view details
  • Click Download to export the version as a JSON file

Step 2: Import or Compare​

  • Use the downloaded JSON to recreate, analyze, or compare prompts across environments
  • JSON exports help sync, audit, or share prompt configurations securely

Additional Notes​

  • Prompt Testing Improvements: Press Ctrl+S (or Cmd+S) to save quickly during edits
  • Improved Save Experience: The tested record is auto-selected after saving
  • Prompt Versioning Settings: A grounding prefix can now be configured when user inputs are added (AI Settings → Preferences)

Benefits of Prompt Versioning​

  • Track every change: See what’s been updated and when
  • Quick recovery: Restore stable prompts in seconds
  • Manage at scale: Migrate prompts across orgs with confidence
  • Share and analyze: Download JSONs for audits and collaboration