Skip to content

Add a Prompt Registry discoverability step to mlflow-onboarding - #34

Open
adamgurary wants to merge 1 commit into
mlflow:mainfrom
adamgurary:onboarding-prompt-registry-step
Open

Add a Prompt Registry discoverability step to mlflow-onboarding#34
adamgurary wants to merge 1 commit into
mlflow:mainfrom
adamgurary:onboarding-prompt-registry-step

Conversation

@adamgurary

Copy link
Copy Markdown
Contributor

Summary

No step in mlflow-onboarding covered how to register a Unity Catalog-backed prompt with mlflow.genai.register_prompt or how to make registered prompts discoverable in the MLflow UI.

A user following the existing onboarding skill would register a prompt successfully but find:

  • No UI link returned or logged
  • The experiment's Prompts tab empty
  • The schema picker showing "nothing to select"

The root cause is that the Prompts tab requires the mlflow.promptRegistryLocation experiment tag to be set, and nothing in the skill mentioned this. Recent mlflow versions set this tag automatically during register_prompt, but the skill gave no guidance on this behavior or the manual fallback for older versions.

Changes

Added step 4 ("Prompt Registry") to the GenAI Integration section of mlflow-onboarding/SKILL.md:

  • Notes that the workspace Prompt Registry preview must be enabled (account admin → Previews) for the UI to show prompts
  • Shows mlflow.genai.register_prompt(name="catalog.schema.my_prompt", template=...) for a UC-backed prompt
  • Notes that register_prompt logs a UI link on success and auto-links the active experiment's Prompts tab to the schema (via the mlflow.promptRegistryLocation tag) on recent mlflow versions
  • Shows prompt_version.uri (prompts:/catalog.schema.my_prompt/1) as the programmatic handle to load the prompt later
  • Includes a fallback for older mlflow: if the Prompts tab is empty, set mlflow.promptRegistryLocation manually with mlflow.set_experiment_tag

No skill covered how to register a UC-backed prompt or make it
discoverable in the MLflow UI. Add a step 4 to the GenAI Integration
section covering:
- workspace Prompt Registry preview must be enabled
- mlflow.genai.register_prompt() with UC three-part name
- register_prompt logs a UI link and auto-links the experiment Prompts
  tab (older versions: set mlflow.promptRegistryLocation manually)
- prompt_version.uri as the programmatic load handle

Co-authored-by: Isaac
Signed-off-by: Adam Gurary <guraryadam@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant