Prompt Library
View all prompts, select an existing one, or create a new prompt from a centralized library.
Message Builder
Compose prompts using System and User messages for chat-style model interactions.
Variables + Inputs
Parameterize prompts with variables and provide runtime values using Fields or JSON.
Model Configuration
Configure the provider, model, and runtime parameters so behavior stays consistent across environments.
Publish Workflow
Publish immutable prompt versions with GitHub-style diffs and review changes before release.
Version History
Track all published versions along with metadata and change history.
Labels
Attach labels such as
production, staging, or latest to control which version applications invoke.Safe Iteration
Create drafts from existing prompt versions and iterate without modifying previously published versions.
When to Use Prompt Studio
Use Prompt Studio when you need a structured way to manage prompts across teams and environments, safely iterate on prompt changes, and control how updates are released to production systems.| Situation | Benefit |
|---|---|
| You want a single place to manage prompts across services and teams | Centralized prompt management |
| You need controlled releases (dev → staging → production) without redeploying code | Safe production rollouts |
| You want an audit trail of prompt changes | Version diffs, comments, and history |
| You want to reproduce outcomes exactly | Pin prompt versions and model settings |
Step by step guide to manage your prompts
Add Messages
Compose your prompt using System and User messages.
- System messages define role, rules, and guardrails.
- User messages contain the request template and runtime input.
Define Variables
Add variables for dynamic inputs such as user messages, context, or knowledge snippets.Reference variables using placeholders like:
{{user_message}}Provide Inputs
Specify how variable values are provided at runtime.
| Method | Description |
|---|---|
| Fields | Structured inputs with name, type, and example values |
| JSON | Runtime JSON payload for programmatic invocation |
Configure the Model
Select the provider, model, and runtime parameters that control how the prompt executes.
Keep temperature low for deterministic tasks such as support replies, extraction, or formatting. Increase it when creativity is needed.
| Setting | Description |
|---|---|
| Provider | The model provider used to run the prompt (for example, OpenAI) |
| Model | The specific model that will generate responses |
| Temperature | Controls randomness in the output |
| Max tokens | Limits the maximum length of the response |
| Top P | Adjusts sampling diversity when generating text |
Publish the Prompt
Click Publish to convert the draft into an immutable version.You can review the change, add a comment, and assign labels.
Immutability and Iteration
Published prompt versions are immutable, meaning they cannot be edited after they are published. This ensures that production behavior remains predictable and that every version can be audited or reproduced later. When you need to update a prompt, you create a new draft, make your changes, and publish a new version.Create a New Draft
Select any published version and create a draft from it.
The draft acts as a working copy where changes can be made safely.
The draft acts as a working copy where changes can be made safely.
Edit and Iterate
Modify messages, variables, or model settings in the draft.
You can iterate and test freely without affecting the currently published version.
You can iterate and test freely without affecting the currently published version.
Best Practices
| Practice | Why It Matters |
|---|---|
| Treat prompts like APIs | Stable inputs and predictable outputs |
| Write publish comments like changelogs | Improves traceability and collaboration |
| Use labels as release channels | Manage deployments safely (dev → staging → production) |
| Keep prompts focused | Compose multiple prompts instead of one large prompt |
| Write clear publish comments | Helps teammates quickly understand what changed |
| Keep changes small and descriptive | Makes it easier to track who changed what and why |
FAQ
Can I edit a published version?
Can I edit a published version?
Published versions are immutable. To make changes, create a new draft from a published version, update it, and publish a new version.
How do I change which prompt runs in production?
How do I change which prompt runs in production?
Move the
production label to the version you want your application to use.