Artifacts¶
An artifact is a reusable, computed output — a metric, a chart, or a table — that BotBoss builds once from your data and can then surface anywhere: on a dashboard, in a chat reply, or behind a shared link, without recomputing or rebuilding it each time.
Think of it as a saved recipe that always serves a fresh result. You (or an agent) define what you want to see, and BotBoss runs the underlying query and caches a snapshot. Anywhere the artifact is embedded, viewers see the rendered result — not a copy of the underlying data.
You won't find a page literally called "Artifacts" in the nav — it's the engine behind two surfaces you do see: Charts & Dashboards. Charts is where you build and hold individual metric/chart/table outputs; Dashboards is where you arrange them into a named view. Agents work with the same underlying artifacts through their tools, so anything an agent builds is exactly as editable, shareable, and permissioned as something you build by hand.
What you can do¶
Create reusable outputs. Open Charts & Dashboards → Charts and start a new one: pick a kind — Chart (line, bar, or pie over a query result), Metric (a single computed number), or Table (a result set as rows and columns) — give it a title, and point it at a data source. Once saved, it's a building block you can reuse across your workspace instead of rebuilding the same query.
Compose by reference. A dashboard is the composite view: use + Add existing chart to pull a saved artifact in alongside others, or + Create new chart to build one inline. Each child resolves independently using its own source and access rules, so adding an artifact to a dashboard never widens what a viewer can reach through it.
Share the output, not the data. When you share a chart or a dashboard, viewers receive the rendered snapshot — the computed result — not access to the underlying tables or connections that produced it. You can hand a stakeholder a live chart without granting them warehouse access.
How it composes¶
| Kind | What it produces |
|---|---|
| Metric | A single computed number or KPI |
| Chart | A line, bar, or pie chart over a query result |
| Table | A tabular result set |
| Dashboard | A named grid of charts, metrics, and tables, resolved by reference |
Leaf artifacts (metric, chart, table) each bind to a data source and produce a snapshot on each refresh. A dashboard holds references to other artifacts rather than copies of them.
Example: build two charts and group them for your CFO¶
- In Charts & Dashboards → Charts, click + Create new chart, pick Metric, title it Revenue this month, and point it at your revenue table.
- Create a second chart the same way — pick Chart, the Line chart tile, title it Monthly trend, and bind it to the same table over time.
- Open (or create) a dashboard, and for each of the two charts click + Add existing chart to bring them in.
- Share the dashboard as Viewer with your CFO.
They see both panels with current data and no warehouse credentials required — and if you later edit the Revenue this month metric, every place it's embedded picks up the change on its next refresh.
Artifacts refresh on demand today, and agents can create, update, and render them through their tools — so your AI teammates can build and maintain charts and dashboards as part of any workflow.