---
title: "Gatlas agents"
description: "Add a Gatlas agent to Slack and choose who can ask it questions."
url: https://www.gatlas.ai/docs/agents
markdown_url: https://www.gatlas.ai/docs/agents.md
---

# Gatlas agents

Add a Gatlas agent to Slack, choose who can ask it, and see who did.

## What a Gatlas agent is

The Gatlas agent answers questions about your portfolio in Slack, from your workspace's Gatlas data. It only reads: it never changes data, a dataset, a sync or a setting. Every figure names its source and how fresh it is.

You can have more than one agent. Each one reads the companies you choose for it, so a group that should see different companies gets its own agent.

## Add it to Slack

1. In Gatlas, go to **Gatlas agents** and open the agent.
2. On its **Channels** tab, choose **Add to Slack**.
3. In Slack, pick the Slack workspace and choose **Allow**.

The person who chose **Allow** gets a direct message from the agent with the next step. Adding the agent takes an admin.

If you cannot install apps in that Slack workspace, choose **Send to a Slack admin** instead. Gatlas can email them the link, or you can copy it and send it yourself. It works once, for up to seven days, and they need no Gatlas account. The link stays on the **Channels** tab while it is open, so you can copy it again, email it again or withdraw it, and you get an email when it is used.

## Choose who can ask

Each Slack workspace the agent is in has one setting, under **Who can ask** on its Channels tab:

- **Anyone in this Slack workspace**: every full member of the Slack workspace, in any channel the agent was invited to, and in direct messages.
- **Only people in chosen channels**: the agent answers in the channels you pick, and in direct messages from their members. Everyone else is told an admin can give them access.

A new Slack workspace starts with **Only people in chosen channels** and nothing chosen, so no one can ask until you pick. To pick a channel, invite the agent to it first: type **/invite @gatlas** in the channel. A private channel such as #finance is a simple way to name exactly who can ask. To let a few people ask in a direct message without a channel, add them under **People who can ask in a direct message**. They still cannot ask in a channel you did not choose.

> **Note:** Removing someone from a chosen channel ends their access within five minutes. Guests and people from other companies in a shared channel never get answers. With **Only people in chosen channels**, group direct messages do not either.

## What it can read

The agent reads only the companies chosen on its **Data** tab. Change them there, and the next question uses the change. It never answers about a company outside them, not even with an estimate.

## Skills, notes and agent credit limit

- **Skills**: ready-made procedures, such as a monthly P&L with variances, that you turn on for the agent on its Skills tab.
- **Notes**: when someone asks the agent to remember a definition or a preference, it saves a note. Admins see, edit and delete notes on its Notes tab. Your own AI agent, such as Claude, ChatGPT or Cursor, reads them too. A note about every company reaches every agent, and a note about one company reaches only the agents that can read it. An admin's agent on their personal Read/write key offers to save a correction you state, as a note or as AI context. It saves only when you say yes.
- **Agent credit limit**: each agent has an agent credit limit in AI credits per month, on its Activity tab, and uses credits from your workspace's credit balance up to it. Admins get an email at 80%, and at 100% the agent stops answering until the month ends.

## See who used it

The agent's **Activity** tab shows who asked it questions, and where:

- **People, last 30 days**: who asked, how often, and their feedback.
- **Channels and DMs, last 30 days**: each channel, and direct messages.
- **Recent conversations**: the latest ones, each with a link to its Slack thread.
- **Refused, last 30 days**: who tried to ask without access, and where.

The Activity tab shows no question or answer text. Open a conversation in Slack to read it.

## Disconnect a Slack workspace

On the agent's Channels tab, choose **Disconnect** beside the Slack workspace. The agent stops answering there at once. Its companies, skills and notes stay.

## Ask the agent for help

Ask the agent how to do something in Gatlas, such as how to let your team ask it questions, and it answers from this help center with a link. When the help center does not solve it, the agent can send a request to the Gatlas team, and only after you approve it in your direct messages.

See also [Team and access](https://www.gatlas.ai/docs/team.md) for roles.
