> Source: https://builder-docs.ema.ai/agent-reference/core/chart-builder
> Title: Chart Builder Agent

# 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.

## Inputs

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
```

## Related Agents

-   [Respond Agent](/legacy-docs/agent-reference/core/respond-to-a-query), often used upstream to produce the markdown response that contains the tables.
-   [Generate Document](/legacy-docs/agent-reference/core/generate-document), for producing full documents that may embed charts.