%md # Create and edit prompts This guide shows you how to create new prompts and manage their versions in the MLflow Prompt Registry using the MLflow Python SDK.
Create and edit prompts
This guide shows you how to create new prompts and manage their versions in the MLflow Prompt Registry using the MLflow Python SDK.
%md ## Install required packages
Install required packages
3
%pip install --upgrade "mlflow[databricks]>=3.1.0" openai dbutils.library.restartPython()
%md ## Step 1. Create a new prompt To create a prompt programmatically, use `mlflow.genai.register_prompt()`. Prompts use double-brace syntax (`{{variable}}`) for template variables.
Step 1. Create a new prompt
To create a prompt programmatically, use mlflow.genai.register_prompt()
. Prompts use double-brace syntax ({{variable}}
) for template variables.
5
import mlflow # Replace with a Unity Catalog schema where you have CREATE FUNCTION privileges uc_schema = "workspace.default" # The following table will be created in the UC schema specified in the previous line prompt_name = "summarization_prompt" # Define the prompt template with variables initial_template = """ Summarize content you are provided with in {{num_sentences}} sentences. Content: {{content}} """ # Register a new prompt prompt = mlflow.genai.register_prompt( name=f"{uc_schema}.{prompt_name}", template=initial_template, # all parameters below are optional commit_message="Initial version of summarization prompt", tags={ "author": "data-science-team@company.com", "use_case": "document_summarization", "task": "summarization", "language": "en", "model_compatibility": "gpt-4" } ) print(f"Created prompt '{prompt.name}' (version {prompt.version})")
Created prompt 'workspace.default.summarization_prompt' (version 1)
%md ## Step 2. Use the prompt in your application The following cells load a prompt from the registry and use it in a simple application.
Step 2. Use the prompt in your application
The following cells load a prompt from the registry and use it in a simple application.
# Load a specific version using URI syntax prompt = mlflow.genai.load_prompt(name_or_uri=f"prompts:/{uc_schema}.{prompt_name}/1") # Alternative syntax without URI prompt = mlflow.genai.load_prompt(name_or_uri=f"{uc_schema}.{prompt_name}", version="1")
from openai import OpenAI # Enable MLflow's autologging to instrument your application with Tracing mlflow.openai.autolog() # Connect to a Databricks LLM via OpenAI using the same credentials as MLflow # Alternatively, you can use your own OpenAI credentials here mlflow_creds = mlflow.utils.databricks_utils.get_databricks_host_creds() client = OpenAI( api_key=mlflow_creds.token, base_url=f"{mlflow_creds.host}/serving-endpoints" ) # Use the trace decorator to capture the application's entry point @mlflow.trace def my_app(content: str, num_sentences: int): # Format with variables formatted_prompt = prompt.format( content=content, num_sentences=num_sentences ) response = client.chat.completions.create( model="databricks-claude-sonnet-4", # This example uses a Databricks hosted LLM - you can replace this with any AI Gateway or Model Serving endpoint. If you provide your own OpenAI credentials, replace with a valid OpenAI model such as gpt-4o. messages=[ { "role": "system", "content": "You are a helpful assistant.", }, { "role": "user", "content": formatted_prompt, }, ], ) return response.choices[0].message.content result = my_app(content="This guide shows you how to integrate prompts from the MLflow Prompt Registry into your GenAI applications. You'll learn to load prompts, format them with dynamic data, and ensure complete lineage by linking prompt versions to your MLflow Models.", num_sentences=1) print(result)
This guide teaches how to integrate prompts from the MLflow Prompt Registry into GenAI applications by loading prompts, formatting them with dynamic data, and maintaining lineage by linking prompt versions to MLflow Models.
Trace(trace_id=tr-242b44488e92b267746a092abf4a5810)
%md ## Step 3. Edit the prompt Prompt versions are immutable after they are created. To edit a prompt, you must create a new version. This Git-like versioning ensures complete history and enables rollbacks. The following cell shows how to create a new version by calling `mlflow.genai.register_prompt()` with an existing prompt name:
Step 3. Edit the prompt
Prompt versions are immutable after they are created. To edit a prompt, you must create a new version. This Git-like versioning ensures complete history and enables rollbacks.
The following cell shows how to create a new version by calling mlflow.genai.register_prompt()
with an existing prompt name:
# Define the improved template new_template = """ You are an expert summarizer. Condense the following content into exactly {{ num_sentences }} clear and informative sentences that capture the key points. Content: {{content}} Your summary should: - Contain exactly {{num_sentences}} sentences - Include only the most important information - Be written in a neutral, objective tone - Maintain the same level of formality as the original text """ # Register a new version updated_prompt = mlflow.genai.register_prompt( name=f"{uc_schema}.{prompt_name}", template=new_template, commit_message="Added detailed instructions for better output quality", tags={ "author": "data-science-team@company.com", "improvement": "Added specific guidelines for summary quality" } ) print(f"Created version {updated_prompt.version} of '{updated_prompt.name}'")
Created version 2 of 'workspace.default.summarization_prompt'
%md ## Step 4. Use the new prompt
Step 4. Use the new prompt
# Load a specific version using URI syntax prompt = mlflow.genai.load_prompt(name_or_uri=f"prompts:/{uc_schema}.{prompt_name}/2") # Or load from specific version prompt = mlflow.genai.load_prompt(name_or_uri=f"{uc_schema}.{prompt_name}", version="2")
%md ## Step 5. Search and discover prompts The following code shows how to search for prompts in Unity Catalog.
Step 5. Search and discover prompts
The following code shows how to search for prompts in Unity Catalog.
# REQUIRED format for Unity Catalog - specify catalog and schema results = mlflow.genai.search_prompts("catalog = 'workspace' AND schema = 'default'") # Using variables for your schema catalog_name = uc_schema.split('.')[0] # 'workspace' schema_name = uc_schema.split('.')[1] # 'default' results = mlflow.genai.search_prompts(f"catalog = '{catalog_name}' AND schema = '{schema_name}'") # Limit results results = mlflow.genai.search_prompts( filter_string=f"catalog = '{catalog_name}' AND schema = '{schema_name}'", max_results=50 )