Chart Builder Agent
The Chart Builder Agent reads tabular data inside your markdown content and renders bar or line charts from it based on the plotting instructions you provide. The rendered charts are inserted into the same markdown, either alongside the source tables or in place of them.
Use Cases
- Visualizing trends and patterns from tabular data.
- Creating quick, chart-based reports for presentations.
- Converting markdown tables into charts.
- Generating performance summaries with visual elements.
- Creating research reports with embedded data visualizations.
| Input | Required | Description |
|---|
| Texts with Markdown | Yes | One or more inputs that contain markdown text with tables. Typically supplied by an upstream agent whose output is markdown, such as a search or retrieval step. |
| Runtime plotting instructions | No | Plotting guidance that can vary per run, usually wired from a user input or another upstream agent. Overrides or refines the config time plotting instructions for that run. |
Outputs
| Output | Description |
|---|
| Texts with charts | The original markdown content with rendered bar or line charts placed inline. When Replace Existing Tables is on, tables are replaced by the charts. When off, the charts follow each table. |
Configurations
| Parameter | Required | Description |
|---|
| Config time plotting instructions | Yes | Static plotting guidance set when building the workflow. This is the primary place to describe what charts you want and how they should look. |
Advanced Configurations
| Parameter | Description | Default |
|---|
| Replace Existing Tables | When on, source tables are replaced by the rendered charts. When off, charts are added alongside the tables. | Off |
| Enable LLM Table Parsing | Normalize messy or irregular tables before charting. Improves results for tables with merged headers or inconsistent rows. | Off |
| Enter figure height (in mm) | Height of each chart image. | 150 |
| Enter figure width (in mm) | Width of each chart image. | 250 |
| Show data point annotations | Prints the numeric value next to each plotted point. | On |
| Decimal places for data point annotations | Precision used when showing point values. | 0 |
| Show average lines | Adds a reference line at the mean of the plotted values. | Off |
| Display legend | Shows the chart legend. | On |
How to Use This Agent
After a knowledge base search returns a response that includes a markdown table of quarterly revenue:
chat_trigger -> knowledge_search -> respond_agent -> chart_builder -> workflow_output
- Respond Agent, often used upstream to produce the markdown response that contains the tables.
- Generate Document, for producing full documents that may embed charts.