Artifacts¶
An artifact is a reusable, embeddable output that BotBoss agents and users can create once and surface anywhere — in a dashboard, a chat message, or a shared link — without copying or rebuilding it each time.
Think of it as a saved recipe that always serves a fresh result. You define what you want to see (a metric, a chart, a table, or a combination), and BotBoss computes the output and caches a snapshot. Anywhere you drop the artifact, viewers see the rendered result — not a copy of the underlying data.
What you can do¶
Create reusable outputs. Build a metric, chart, or table once and give it a stable identity. An artifact has a title, a kind, and a data source — a saved query against your connected data or a literal value you supply. Once saved, it's a building block you can use across your workspace.
Compose by reference. A composite artifact groups other artifacts into a single named view. Pick which artifacts to include, arrange them in a grid, and the composite resolves each one independently — so you can group metrics into a panel, and panels into a summary, without duplicating a single query.
Share the output, not the data. When you share an artifact today, 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¶
Every artifact is one of four kinds:
| Kind | What it produces |
|---|---|
metric |
A single computed number or KPI |
chart |
A line or bar chart over a query result |
table |
A tabular result set |
composite |
A grid of other artifacts, resolved by reference |
Leaf artifacts (metric, chart, table) each bind to a data source and produce a snapshot on each refresh. A composite holds references to other artifacts; when rendered, each child resolves using its own source and access rules, so embedding a child never widens what a viewer can reach.
Example. You build a Revenue this month metric and a Monthly trend chart as two artifacts, then create a Finance summary composite that references both. Drop the composite into a dashboard or share it with your CFO — they see both panels, current data, no warehouse credentials required.
Artifacts refresh on demand today, and agents can create, update, and render them through their tools — so your AI teammates can build and maintain outputs as part of any workflow.