---
title: "Build artifacts and components"
description: "Build a dashboard, document or deck from approved datasets, save a component, and reissue a share link."
url: https://www.gatlas.ai/docs/playbooks/artifacts
markdown_url: https://www.gatlas.ai/docs/playbooks/artifacts.md
---

# Build artifacts and components

Gatlas copies a business's numbers and files from the tools it uses into one place that AI agents can read. A Gatlas artifact is a dashboard, an A4 document or a slide deck made from approved datasets, and a component is one chart, figure, table or text block placed in any number of artifacts. This playbook builds both, and gives an artifact a new share link.

## How to run

Run the section the person's prompt names. If it names none, ask what they want to do and pick the section that fits.

Do each step yourself with Gatlas's tools. Pause only for an approval the person must give. Describe what you will build before you build it.

Ask one question at a time, and wait for the answer before the next. Never ask for a key or a password in this chat. Before you change anything in Gatlas, tell the person exactly what will change and wait for their yes. Never delete anything.

## Before you start

Check that you can see Gatlas tools such as list_companies. If you cannot, stop and walk the person through [Connect Gatlas to your agent](https://www.gatlas.ai/docs/playbooks/connect-your-agent.md) first, then come back here.

## Build an artifact

Help the person build an artifact in Gatlas: a dashboard, an A4 document or a slide deck made from their approved datasets. Ask what it should show and who will read it.

Use list_datasets and describe_dataset to find the datasets, and query_dataset to check the numbers. Describe the layout and each chart, table and text block before you build anything. Once they say yes, create it with create_artifact.

Before you change anything in Gatlas, tell the person exactly what will change and wait for their yes. Never delete anything.

## Build a component

Help the person build a component in Gatlas: a chart, figure, table or text block that they can place in any number of artifacts. Ask what it should show and which artifacts will use it.

Use list_components to check whether one already shows it, list_datasets and describe_dataset to find the data, and query_dataset to check the numbers. Describe the component before you build it. Once they say yes, create it with create_component.

Before you change anything in Gatlas, tell the person exactly what will change and wait for their yes. Never delete anything.

## Reissue a share link

The share link of a Gatlas artifact was revoked, so it no longer opens. The prompt names the artifact, or says it is the one the person has open. Help them issue a new one. It needs their personal key or a whole-workspace key.

Once they say yes, reissue its share link with edit_artifact and give them the new link. Remind them that anyone with the link can open the artifact without logging in.

Before you change anything in Gatlas, tell the person exactly what will change and wait for their yes. Never delete anything.
