Artifacts
An artifact is a dashboard, a document or a deck that your agent builds for you from your approved datasets. Its charts and figures read your data every time it opens, so the monthly board pack is built once and stays current.
Build an artifact
You build and change an artifact by asking your agent. The dashboard has no artifact editor. Building one needs your agent connected with a Read/write key, since it saves something; see Agent access.
Describe what you want to see
Name the question, the companies and the format. For example:
Build a dashboard called "Portfolio monthly" with revenue by company for the last 12 months as a bar chart, this month's total revenue as a big number, and a table of the ten largest overdue invoices.
Turn our monthly P&L for Northwind into a four-page A4 document for the board, with a short written summary on the first page.
Open it in Gatlas
Your agent replies with where to find it. In the dashboard, open Artifacts, under Artifacts in the sidebar, and open it by name.
Change it by asking
Ask for changes in the same way: "add a line chart of gross margin", "make it a deck", "rename it Portfolio Q3". Gatlas checks each change against your datasets before it saves, and refuses a chart that would not work.
Tip
Formats
- Dashboard: rows of charts and figures that reflow on a phone. It can group components into tabs.
- Document: A4 pages, drawn on screen the way they print.
- Deck: 16:9 slides, shown one at a time; the arrow keys move between them.
Inside any format, an artifact is made of components: line, bar, area and pie charts, a single big number, a table, and text. Every chart, number and table reads one approved dataset, so an artifact shows only figures your datasets hold.
Saved components
Components, under Artifacts in the sidebar, lists the charts, big numbers, tables and text your workspace has saved. Ask your agent to save one, then place it in any dashboard, document or deck. Change a saved component, and every artifact it sits in changes with it.
How figures update
- The figures are as fresh as the datasets they read. When a dataset refreshes, the artifact shows the new numbers the next time it opens. Someone opening it from the share link may see figures from before the latest refresh. Opening it again a moment later shows the current ones.
- If a dataset is renamed, the artifact follows it. If a dataset is deleted or loses its approval, only the components that read it show a notice; the rest of the artifact still draws.
- In Gatlas, people see the artifacts for the companies they have access to.
- An edition is the exception: its figures stay as they were when it was made. See Editions below.
Editions
An edition is a numbered copy of a deck or document, frozen with every figure as it stood when you made it. Send one when the board should read the same numbers next month as today, where the share link is always current. Click Make a snapshot on the artifact's page.
Each edition is listed under Editions on that page, with the day it was made and the day its data is from. It has its own link that anyone can open without logging in, and Copy link copies it. Download PDF saves it, and each page's footer names the edition and the day its data is from. The first download takes a few seconds while the PDF is drawn.
Important
Only admins and owners whose access is All companies can make, copy and withdraw editions, and only of a deck or document. Your agent can make one too: ask it to make an edition of the board pack. This needs a Read/write whole-workspace key.
Delete an artifact
Ask your agent to delete the artifact. It first tells you what will go, including the share link and how many editions are live, and deletes only once you confirm. There is no undo. Deleting an artifact also deletes its editions: every edition's link stops working and their PDFs are gone. Deleting needs a Read/write personal or whole-workspace key, and a whole-workspace key once the artifact has editions.