analyzing-mlflow-session

Extract inputs, outputs, and per-turn assessments from MLflow session traces.

4|4|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/RamVegiraju/databricks-samples --skill analyzing-mlflow-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyzing-mlflow-session
Source: https://github.com/RamVegiraju/databricks-samples/tree/main/.claude/skills/analyze-mlflow-chat-session
Command: npx skills add https://github.com/RamVegiraju/databricks-samples --skill analyzing-mlflow-session

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill analyzes an MLflow session — a sequence of traces from a multi-turn chat conversation or interaction. It helps you debug a chat conversation, review a session or chat history, find where a multi-turn chat went wrong, or analyze patterns across turns. Traces within a session are linked by a shared session ID stored in trace metadata.

Core Features & Use Cases

  • Reconstruct conversations by collecting per-turn inputs and outputs from root span attributes (e.g., mlflow.spanInputs/mlflow.spanOutputs) and linking traces by session ID.
  • Identify schema and key fields, inspect assessments, and audit session-level vs per-turn evaluations to pinpoint where issues originate.
  • Analyze multi-turn session quality across turns, detect drift or inconsistencies, and surface actionable insights for debugging.

Quick Start

Run the discover_schema.sh script to identify the session inputs/outputs, then inspect individual turns with the inspect_turn.sh script.

Frequently Asked Questions about analyzing-mlflow-session

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

FAQPage Schema
How do I debug a multi-turn chat conversation in MLflow?

You can debug MLflow multi-turn chat conversations by extracting per-turn inputs and outputs from root span attributes, linking traces by session ID to pinpoint exactly where conversations degrade. This allows you to review chat histories and spot conversational drift.

What is an MLflow session and how does trace analysis work?

An MLflow session is a sequence of traces from a multi-turn chat conversation linked by a shared session ID in trace metadata. Trace analysis extracts inputs, outputs, and per-turn assessments from these traces to evaluate session quality and detect conversational drift.

How do I inspect individual turns in an MLflow chat session?

You inspect individual MLflow chat session turns by running the discover_schema.sh script to identify session inputs and outputs, then using the inspect_turn.sh script to analyze specific turns and audit per-turn evaluations for issues.

Do I need jq to analyze MLflow traces?

Yes, you need jq and mlflow installed to analyze MLflow traces. These dependencies are required to fetch traces using the session ID and parse field paths like mlflow.traceInputs and mlflow.traceOutputs to reconstruct conversation turns.

Can I find where a multi-turn chat went wrong using MLflow traces?

Yes, you can find where a multi-turn chat went wrong by analyzing MLflow traces to audit session-level versus per-turn assessments. This process surfaces actionable insights and detects drift or inconsistencies across individual conversation turns.

What are the limitations when debugging MLflow session traces?

A limitation when debugging MLflow session traces is that the analysis relies entirely on accessing existing traces and specific field paths like mlflow.spanInputs and mlflow.spanOutputs. If traces lack a shared session ID, conversation reconstruction will fail.