---
title: "Agent playbooks"
description: "Setup steps your agent follows with you."
url: https://www.gatlas.ai/docs/playbooks
markdown_url: https://www.gatlas.ai/docs/playbooks.md
---

# Agent playbooks

When a page in Gatlas offers a prompt for your agent, the prompt names a playbook below and the section to follow. Your agent fetches it, asks one question at a time and waits for your yes before it changes anything.

## How a playbook works

Each playbook is a page here and a Markdown file beside it, at the same address with .md at the end. Your agent reads the Markdown, so the steps it follows are always the current ones. You never paste a key into the chat: a key goes only into Gatlas's own pages.

## Playbooks

- [Build artifacts and components](https://www.gatlas.ai/docs/playbooks/artifacts.md): Build a dashboard, document or deck from approved datasets, save a component, and reissue a share link.
- [Plan your automations](https://www.gatlas.ai/docs/playbooks/automations.md): Plan the alerts, scheduled Slack messages, dataset copies, reports and brief prompts Gatlas runs for you.
- [Connect your tools](https://www.gatlas.ai/docs/playbooks/connect-tools.md): Connect the tools your companies run on, send setup links, and keep every connection syncing.
- [Connect Gatlas to your agent](https://www.gatlas.ai/docs/playbooks/connect-your-agent.md): Add Gatlas to the agent you are using, log in on Gatlas's own page, and ask a first question.
- [Build and find datasets](https://www.gatlas.ai/docs/playbooks/datasets.md): Build a dataset from synced tables, find the approved dataset that answers a question, and read a table.
- [Read files and keep briefs current](https://www.gatlas.ai/docs/playbooks/files-and-briefs.md): Choose the folders Gatlas reads, read a synced file, and set up and read the briefs agents read first.
- [Reconnect a tool](https://www.gatlas.ai/docs/playbooks/reconnect-a-tool.md): For a company contact with a Gatlas setup link open, signing in to a tool again so it syncs.
- [Set up your workspace](https://www.gatlas.ai/docs/playbooks/set-up-your-workspace.md): Gather what setup needs, plan your companies, write their AI context and describe a dataset before you approve it.
- [Plan your team and agent keys](https://www.gatlas.ai/docs/playbooks/team-and-access.md): Plan who joins your workspace with which role, who gets an agent key, and a Gatlas agent for Slack.
