Widgets

A widget is a table, card, form or chart an agent shows in a conversation, filled with data each time.

A widget is a piece of interface an agent shows in a conversation: a table, a summary card, a form or a chart. You design it once, and the agent fills it with data each time. Its parameters tell the agent what to supply, and Mindset refuses data in the wrong shape.

For the invoice exceptions agent, a widget can show the invoice lines next to the purchase order lines, with each difference marked.

Why it matters#

Every conversation shows the same layout, and data in the wrong shape never reaches the screen.

Built in#

Every agent can show these without a widget:

Tool	Shows
`render_chart`	A bar, line or pie chart from numbers the agent supplies
`show_table`	A sortable table
`show_callout`	One highlighted box: info, success, warning or danger
`show_ui`	One small card, badge or headline number

Build a widget when you want the same layout every time.

Live demoWidget round trip · Kettle & CoThe agent offers a grind picker in the chat, and your tap changes the coffee page in reply.

Versions#

A conversation always shows the widget's active version, so a published change reaches conversations already in progress on their next turn. An agent version records which widgets the agent uses, not which version of each.

To build one, see Show a widget. To draw it in your own interface, see Use your own UI.