Versioning in Promptitude allows you to create and manage multiple iterations of your elements while maintaining control over what's in production and what's in testing.
This feature helps you experiment with different configurations without disrupting your live environment. In this article, we'll explore how versioning works and how you can leverage it to improve your workflow.
🔄 What is Versioning in Promptitude?
Versioning is a feature that enables you to save different "snapshots" or iterations of an element (like a Snippet) as separate versions. Each version maintains its own configuration and content, allowing you to:
Test new ideas without affecting your production environment
Keep a history of changes
Easily switch between different configurations
Maintain quality control in your generations
Think of versions as different drafts of the same document, each preserved at different stages of development.
✏️ How Does Versioning Work?
Creating and Editing Versions
Versions in Promptitude are created automatically in ascending numerical order. Here's how the process works:
When you make changes to an item, go to Save, click on the submenu (arrow icon), and select New version to create a new iteration.
Each version is assigned a sequential number (Version 1, Version 2, etc.)
To access a specific version, simply select it from the version dropdown menu near the save button
Once selected, your screen will update to display the chosen version
From there, you can edit or review the configuration of that specific version
The system is designed to be intuitive, allowing you to seamlessly switch between different iterations of your content.
What Actions Can You Perform with Versions?
The version menu provides several important actions:
Make Live: Sets the selected version as the active production version. Remember, only one version can be live at any time.
Set as Preview: Designates the version for staging/testing purposes. Similar to the live version, only one version can be in preview status.
Edit Version Details: Allows you to modify the name and description of the selected version, making it easier to identify its purpose.
Delete Version: Removes the version from your list if it's no longer needed.
Understanding Version Statuses
Versions in Promptitude can have one of three statuses:
Live: This is your production version—the one that's actively being used in your live environment. This status is for versions that are in development and require monitoring.
Preview: This is your testing version, allowing you to experiment without affecting your production environment. Preview versions facilitate development and testing.
Draft: All other versions that aren't designated as Live or Preview fall into this category. These are your works in progress or archived versions.
✅ Benefits of Versioning
Risk-Free Experimentation: Test new ideas without disrupting your live environment
Quality Control: Thoroughly evaluate changes before making them live
Version History: Keep track of when changes were made and by whom
Easy Rollback: Quickly revert to a previous version if needed
Collaborative Workflow: Different team members can work on different versions
Transparent Development: Maintain visibility into the evolution of your content
🎯 Where Can You Find Versioning in Promptitude?
Currently, versioning is in its Beta phase and is available in the Snippets section of Promptitude. This allows you to create different versions of your snippets for easy testing from Prompts.
When working with versioned snippets:
The snippet with Live status will be automatically selected from your prompt
If you want to test a different version, you can select its Preview status
For manual configuration from a prompt or chat, you can use subvariables with the following structure:
{{snippet.name.live}}to use the live version{{snippet.name.preview}}to use the preview version
📌 Note: This structure is valid for both development within Promptitude and integration via API.
⏳ Version History
In addition to the versioning feature itself, you'll have access to a version history. In its first phase, this history is purely informative, showing:
Version numbers
Start and end dates for each version
The user who performed each action
Status changes (Live or Preview)
This comprehensive tracking allows you to maintain full visibility of any changes that might affect your external integrations via API or your tests within the application.
As Promptitude continues to evolve, the versioning feature will expand to other elements beyond Snippets, providing you with even more control over your prompt management workflow.