agent-evaluation

Evaluate and optimize LLM agents using MLflow's evaluation API.

69|21|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/mlflow/skills --skill agent-evaluation-mlflow-2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-evaluation
Source: https://github.com/mlflow/skills/tree/main/agent-evaluation
Command: npx skills add https://github.com/mlflow/skills --skill agent-evaluation-mlflow-2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlflow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive workflow for evaluating and optimizing the performance of LLM agents, ensuring high-quality outputs and effective observability.

Core Features & Use Cases

  • End-to-End Evaluation: Supports the complete evaluation workflow, including dataset creation, scorer definition, and result analysis.
  • Scorer Registration: Utilizes MLflow's scorer API to register and apply quality scorers to evaluate agent performance.
  • Dataset Preparation: Offers tools for discovering existing datasets and creating new ones tailored to the agent's purpose.
  • Dry Run: Performs a preliminary evaluation on a small subset of the dataset to identify and resolve potential issues before running the full evaluation.
  • Evaluation Execution: Executes the evaluation using MLflow's evaluate API, ensuring traceability and observability.
  • Result Analysis: Analyzes the evaluation results, identifying areas for improvement and providing actionable recommendations.
  • Use Case: Suppose you have an LLM agent designed to answer questions about medical information. Use this Skill to evaluate its accuracy, identify common errors, and optimize its responses for improved reliability.

Quick Start

Run the following command to evaluate your agent: uv run python scripts/run_evaluation_template.py --module my_agent.agent --entry-point run_agent --dataset-name my-dataset

Frequently Asked Questions about agent-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate LLM agents using MLflow?

Evaluating LLM agents using MLflow involves a workflow of dataset creation, scorer definition, and result analysis. The process leverages MLflow's evaluation API to ensure traceability and observability of agent performance.

What is the best way to run a preliminary evaluation before testing my full LLM agent dataset?

The best way to run a preliminary evaluation is to perform a dry run on a small subset of your dataset. This identifies and resolves potential issues using MLflow's evaluation API before executing the full evaluation.

Does MLflow support registering custom scorers for LLM agent evaluation?

Yes, MLflow supports registering custom scorers for LLM agent evaluation. You can utilize MLflow's scorer API to register and apply quality scorers to measure and optimize the performance of your agents.

How do I prepare datasets for evaluating my LLM agent?

To prepare datasets for evaluating your LLM agent, you can use provided tools to discover existing datasets or create new ones. These datasets are tailored to your agent's specific purpose to ensure accurate evaluation results.

Can I use this workflow to analyze evaluation results and improve my LLM agent?

Yes, you can analyze evaluation results to improve your LLM agent. The workflow analyzes the results from MLflow's evaluate API, identifies areas for improvement, and provides actionable recommendations for optimization.