query_runs
Read-only
Filter and sort MLflow runs using MLflow's filter syntax, with pagination support for large result sets.
Instructions
Query runs using MLflow's filter syntax with optional sorting.
Runs can be large. Use wise limits to avoid flooding context.
Args:
experiment_id: The experiment ID
query: MLflow filter string (e.g., 'metrics.accuracy > 0.9')
limit: Maximum number of runs to return
offset: Number of runs to skip
order_by: List of sort clauses, e.g. ['metrics.rmse DESC', 'params.lr ASC'].
Use backticks for special characters: ['metrics.trading/loss DESC']
Examples:
query_runs("1", "metrics.accuracy > 0", order_by=["metrics.accuracy DESC"])
query_runs("1", "", order_by=["metrics.f1/score DESC"])
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| experiment_id | Yes | ||
| query | Yes | ||
| limit | No | ||
| offset | No | ||
| order_by | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |