Available Widget Types
Data-Driven Widgets
These widgets require queries and compute results from evaluation data:Metric Widget
Display a single computed value like averages, counts, or percentiles
Table Widget
Show multi-dimensional data in rows and columns with grouping and sorting
Bar Chart
Visualize comparisons across categories with bar charts
Histogram
Display data distributions across numerical ranges
Static Content Widgets
These widgets display static content without queries:Markdown Widget
Add rich text documentation, instructions, and notes
Heading Widget
Organize dashboards with section headers
Quick Reference
| Widget Type | Purpose | Requires Query | Best For |
|---|---|---|---|
| Metric | Single aggregation value | Yes | Top-level metrics, summary stats |
| Table | Tabular data display | Yes | Detailed breakdowns, grouped data |
| Bar | Bar chart visualization | Yes | Categorical comparisons |
| Histogram | Distribution visualization | Yes | Understanding distribution of data |
| Markdown | Rich text content | No | Documentation, instructions, notes |
| Heading | Section headers | No | Dashboard organization |
Choosing the Right Widget Type
Display a Single Number
Use a Metric widget when you need to show one computed value prominently:- Overall average score
- Total item count
- Pass rate percentage
- 95th percentile latency
Show Detailed Breakdowns
Use a Table widget when you need to display multiple dimensions and metrics:- Performance by model and category
- Top 10 highest/lowest scoring items
- Multi-column statistical summaries
Compare Categories
Use a Bar Chart widget to visualize how values differ across groups:- Score by category
- Model performance comparison
- Items per status
Visualize Distributions
Use a Histogram widget to understand how values are distributed:- Score distribution
- Latency distribution
- Confidence level spread
Add Documentation
Use Markdown widgets for context and instructions:- Dashboard methodology
- Alert thresholds
- Team contact information
- Analysis guidelines
Organize Sections
Use Heading widgets to structure your dashboard:- “Overview Metrics”
- “Detailed Analysis”
- “Performance by Category”
Widget Configuration Overview
All widgets share common fields: Required Fields:title: Display name for the widgettype: One of: metric, table, bar, histogram, markdown, heading
query: QueryAST object defining the computation
config: Widget-specific display configuration
Data Sources
Data-driven widgets can query two sources:data.*: User-defined evaluation data (your custom fields)task_result_cache.*: Task execution results
data.metadata.model_version).
Reusing Widgets
Widgets can be shared across multiple dashboards. When you include the same widget ID in different dashboards’widget_order, they all use the same widget definition but produce different results based on their evaluation context.
Next Steps
Explore detailed documentation for each widget type:- Metric Widget - Single value displays
- Table Widget - Tabular data
- Bar Chart Widget - Category comparisons
- Histogram Widget - Distribution visualization
- Markdown Widget - Rich text content
- Heading Widget - Section headers
- Query Language - Build powerful queries
- Getting Started - Create your first dashboard
- API Reference - Explore programmatic query creation