What problem does it solve?
Provide clear, production-ready patterns and reference material to design, run, and maintain MLflow GenAI evaluations so teams can measure and improve agent and RAG quality without ad-hoc scripts or fragile workflows.
Core Features & Use Cases
- Evaluation workflows: End-to-end patterns for first-time setup, building eval datasets from production traces, running mlflow.genai.evaluate, and comparing named runs for regression detection.
- Scorers & Judges: How to use built-in scorers (Guidelines, Correctness, Safety, RetrievalGroundedness), author @scorer functions, and create custom LLM judges with make_judge.
- Judge alignment & optimization: Procedures for aligning judges with MemAlign using SME labels and for automated prompt improvement with GEPA (optimize_prompts).
- Trace & dataset patterns: Converting tagged traces into evaluation datasets, MLflow-managed UC datasets, and patterns for trace ingestion and production monitoring.
- Operational best practices: Critical gotchas, API signatures, data schema requirements (nested inputs, predict_fn signature), and guidance for production monitoring and cost-aware embedding choices.
Quick Start
Run mlflow.genai.evaluate with a dataset of records containing an inputs key (and expectations when needed), a predict_fn that accepts unpacked kwargs, and scorers such as Safety(), Guidelines(name="x", guidelines="..."), or an aligned judge.