ModelRefs / Prompt Management — AI Glossary
Prompt Management — AI Glossary
Versioning, testing, and deploying prompts as first-class software artifacts with change history and staged rollouts.
Overview
Prompt management tools (LangSmith Hub, Braintrust, Langfuse) store prompt templates with version history, attach eval results, and enable A/B testing between prompt versions before production rollout.
Reference details
| Topic | operations |
|---|---|
| Last reviewed | 2026-06-24 |
Related terms
How it works
- Prompts are stored outside the application as named templates with version history, so changing one is not a code deploy.
- The application fetches by name and label rather than by version number — production, staging — which is what lets a promotion happen without a release.
- Each version is linked to the evaluation results it produced, so a comparison between two prompts is a lookup rather than a reconstruction.
- Traces record which version served each request, which is the only way to attribute a complaint to a prompt change after the fact.
- Rollback is re-pointing the label at the previous version, so recovery time is independent of the deploy pipeline.
Example: Why the version has to be on the trace
A quality complaint arrives about requests from Tuesday. Three prompt versions shipped that week. Without a version recorded per request there are three candidates and no way to choose, so the investigation becomes a re-run of guesses. With the version on each trace the Tuesday requests resolve to one version, and its own evaluation results are already attached. The storage cost is one identifier per request; the alternative cost is an unfalsifiable argument.
Commonly confused with
Prompt engineering is writing the prompt; prompt management is the operational layer around it — versioning, staged rollout, and knowing which version produced which result. The reason to separate them is that a prompt edit is a production change with no code diff, so without this layer a quality regression has no bisect path and no rollback.
When to use it
Reach for it when:
- Prompts change more often than the application deploys.
- A bad prompt must be revertible in seconds, independently of the release pipeline.
- Someone has to answer which prompt version produced a specific output.
Reach for something else when:
- A single stable prompt that changes with the code and is reviewed with it.
- Prototyping, where the indirection costs more than it protects.
- Without trace-level version recording, which removes most of the benefit.
Continue your research
Use these connected ModelRefs sections to compare alternatives, inspect implementation paths, and review the evidence and governance boundaries relevant to Prompt Management — AI Glossary.
Frequently asked questions
What is Prompt Management?
Versioning, testing, and deploying prompts as first-class software artifacts with change history and staged rollouts.
What concepts are related to Prompt Management?
Closely related concepts include llmops, eval, prompt engineering.