Skip to content
Changelog

Show a headline number on agent charts

October 29, 20261 min read

Your agent can now lead a chart with one number. Agno's ChartTools adds an optional value argument to create_chart(), and Agno OS shows that figure beside the chart title.

ChartTools().create_chart(
    chart_type="bar",
    data=rows,
    config={"revenue": "Revenue ($)"},
    title="Monthly revenue",
    value="$139K",
    x_key="month",
)

We ran this call with six months of revenue rows on both releases, and earlier releases reject the argument. Real output:

Before: TypeError: ChartTools.create_chart() got an unexpected keyword argument 'value'
Now:    "value": "$139K",

The figure can be a total or a latest value, and it arrives already formatted. A chart of averages or rates may have no honest single number, so the model gets told to leave the argument out in that case.

See the cookbook, and learn more about toolkits in the documentation.

Frequently asked questions

create_chart() copies value into the chart block as a "value" field, and Agno OS displays that figure beside the chart title. Leave the argument out and the block has no such field.

No. ChartTools passes along the string it receives, so the model or your code formats the figure. The tool description asks the model to skip value when no single number summarizes the chart and never to invent one.

A call with six months of revenue rows returned a fenced chart block whose JSON holds "title": "Monthly revenue", "value": "$139K", "xKey": "month" and "yKeys": ["revenue"], next to the chart type, rows and series config.

Shipped around the same time