Skip to content

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.