Overview
The Visualization Agent transforms your data into interactive charts and visualizations. Describe what you want to see in plain English, and it analyzes your data, selects the right chart type, generates a validated Vega-Lite specification, and renders it directly in the BrightAgent interface — with tooltips, responsive layouts, and proper formatting.Demo: Visualization Agent in Action
This demo starts at 14:15 and shows the visualization agent creating charts and dashboards.
What You Can Ask
- “Show me a bar chart of sales by region”
- “Create a trend line of customer acquisition costs over the past year”
- “Display the correlation between marketing spend and revenue”
- “Generate a breakdown of our top product categories”
- “Compare this quarter’s metrics to last quarter as a pie chart”
- “Show me a heatmap of activity by day and hour”
How It Works
- You describe what you want — Natural language request for any visualization, with optional chart type preferences.
- Data is prepared — The Analyst or Retrieval Agent queries your warehouse and returns results, or the agent reads from existing artifacts.
- Phase 1: Planning — An LLM analyzes a data sample to understand column types, distributions, and patterns. It selects the optimal chart type and maps columns to visual encodings.
- Phase 2: Generation — A more capable LLM produces a complete Vega-Lite v6 specification following the plan — including axes, colors, tooltips, and responsive layout.
- Validation — The specification is validated against the Vega-Lite schema. If invalid, the agent applies a retry strategy with error context until the specification passes.
- Rendered in BrightAgent — The chart appears as an interactive ChartViewer component with hover tooltips, responsive scaling, and proper formatting.
Chart Type Selection
The agent automatically recommends the best visualization based on your data characteristics:| Data Pattern | Chart Type | When Used |
|---|---|---|
| Categories + numbers | Bar chart | Comparing values across groups |
| Time series | Line chart | Showing trends over time |
| Filled time series | Area chart | Emphasizing volume or cumulative trends |
| Two numeric variables | Scatter plot | Exploring relationships and correlations |
| Part-of-whole | Arc / donut | Showing composition or proportions |
| Distributions | Histogram / box plot | Understanding data spread and outliers |
| Dense matrices | Heatmap | Showing patterns across two dimensions |
| Geographic data | Map-based | Spatial analysis and regional comparisons |
Interactive Features
Every chart includes built-in interactivity:Tooltips
Hover over any data point to see detailed values. Tooltips automatically include relevant fields from your data.
Responsive Layout
Charts automatically scale to fit the available space — from full-width dashboards to mobile views.
Color Encoding
Categories are automatically distinguished by color using accessible palettes. Numeric values can use gradient scales.
Intelligent Formatting
Numbers, dates, currencies, and percentages are formatted appropriately based on data type — no manual configuration needed.
Data Sources
The Visualization Agent receives data through multiple pathways:- From the Analyst Agent — Pre-analyzed data ready for charting, often as part of a multi-step workflow
- From the Retrieval Agent — Raw query results from your warehouse, passed as artifacts with full metadata
- From S3 files — Data files generated by other agents or uploaded directly, read from your organization’s storage
Works With Other Agents
- Analyst Agent provides aggregated query results and statistical insights that feed directly into visualizations.
- Retrieval Agent identifies and fetches the right data assets, creating artifacts the Visualization Agent can consume.
- BrightAgent coordinates multi-step workflows like “analyze sales by region and chart it” — routing through Retrieval, Analyst, and Visualization in sequence.
The Visualization Agent is part of the BrightAgent architecture. See capabilities for the full list of what BrightAgent can do.