Skip to main content

Prompt Versioning

In Genum, versioning isn't just history — it's your control panel for prompt logic, AI model configs, and regression stability.

Versioning is a core concept in Genum. It ensures that prompt specifications — along with all related configurations — are captured, traceable, and explicitly committed before going live.

How Versioning Works​

Each prompt has a single main branch.

  • At any moment, your prompt is either in a committed or uncommitted state.
  • All prompt edits, model tweaks, schema changes create an uncommitted draft.

When you're ready:

  • Run regression tests
  • Ensure correctness
  • Then click Commit to save the version

Once committed, it becomes the new stable version.

AI-Powered Commits​

During commit, Genum can auto-generate:

  • Commit title
  • Commit description

These are derived from the prompt changes and test behavior using internal AI agents.

Versoning commit

What a Version Includes​

A prompt version captures everything needed to reproduce behavior:

  • Prompt content
  • Model settings (e.g., model name, temperature, max tokens)
  • JSON schema (if defined)
  • Audit report and score

This allows any version to be replayed or deployed as-is.

Productive Version Selection​

When integrating prompts via the API, you can choose:

  • productive: true/false

This makes it easy to:

  • Test drafts
  • Promote stable specs
  • Deploy with precision

Important: Default Behavior for External Integrations​

⚠️ Important Notice: By default, external integrations via REST API and custom nodes will use the last stable/committed version of your prompt.

This ensures that:

  • Production stability: Only tested and committed versions are used in live integrations
  • Predictable behavior: External systems always get the same prompt version unless explicitly specified
  • Safety: Uncommitted drafts are never accidentally deployed to production

To use a specific version or draft, you must explicitly specify the version ID in your API calls.

Rollback & History​

Genum keeps full commit history. You can:

  • Rollback to any previous committed version
  • Restore full prompt + model configuration

Version Comparison​

Use Genum's built-in diff view to:

  • See changes in prompt content
  • Track differences in model parameters
  • Understand regression behavior between versions

In Genum, versioning is a first-class system — tightly integrated with testing, logging, and deployment.

Commit when you're ready. Revert when you need. Review when you must. ✅