> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minerva.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Minerva Agent overview

> Ask questions, analyze your data and take action, in the Agent chat or with Ask Minerva on the page you're working on

Minerva Agent is an AI that can find people and build segments, analyze your connected data, write reports, prepare activations, and research and plan with you. Use it in the Agent chat, or select **Ask Minerva** on the page you're working on. It's the same Agent, with the same permissions.

| Where | How to open it | Best for |
| - | - | - |
| Agent chat | Select [**Agent**](https://app.minerva.io/agent) in the sidebar. | Longer conversations, analysis and reports. |
| Ask Minerva, in the side panel | Select **Ask Minerva** on the page you're working on. On Home, Reports and the Agent pages, you get the full chat instead. | Questions and changes about what's on that page. |

## What you can ask it to do

Ask for any of these in plain language. Some need your data to be connected first.

| You want to | What it needs |
| - | - |
| Find new people and build a segment | Nothing to connect. The Agent searches Minerva's data on 270 million Americans. |
| Find people among your own customers | Your customer data, connected and ready to search. |
| Analyze revenue, orders, ad spend or conversions | The relevant sources, connected and ready for analysis. |
| Use Personas or propensity scores | Your customer and order data. Propensity scores also need scoring turned on for your organization. |
| Activate or export a segment | Enough room in your [operational limits](https://docs.minerva.io/platform/workspace/billing-and-usage.md), and in your record export allowance where it applies. Destinations other than a CSV file also need a working connection. |
| Write a report | The data the report draws on: a segment, your connected data or public research. |
| Analyze a file | A file you attach to the message. |
| Research a topic, plan or write | Nothing to connect. |

These are the same requirements that apply when you use these features yourself.

## Start a chat

**1. Open the Agent**

Select **Agent** in the sidebar and start a **New chat**, or open an earlier conversation.

**2. Write your request**

Say what you want to know and the result you want. For analysis, include the period, the comparison and how you define the metric.

**3. Add files or a skill**

Attach files if you need them, or type `/` to choose a skill.

**4. Send and read the answer**

Read the answer along with its sources and any caveats the Agent notes about the data.

**5. Follow up**

Keep going in the same chat. Ask for a report when you want a document you can reopen and share.

## Use the side panel

In the side panel, the Agent knows which page you're on and what that page shows. Ask it about the result, selection or form in front of you.

It can also take actions that the page supports, for example:

| Where you are | What you can ask it to do |
| - | - |
| A segment | Switch views, open a person, save or rename the segment, request scoring or set up a PDF report. |
| Bulk Enrich | Choose a sheet, map fields and start an enrichment you've prepared. |
| Personas | Add your own persona once personas have been generated, edit a persona in your library, or run **Find more**. |
| Integrations | Add integrations to **Setup**. You still sign in to the other tool yourself. |
| Context | Update your company Context. |

The Agent works within your account's permissions. To continue a conversation in the Agent chat, select **Open chat in full page**.

## Attach files

| File type | How the Agent uses it |
| - | - |
| PNG, JPEG, WebP and GIF images | Reads the image. |
| PDF | Reads the document. |
| TXT and Markdown | Reads the text. |
| CSV | Shows a short preview and can analyze the whole file. |
| Excel (XLS and XLSX) | Converts each sheet that has data into its own CSV. |

You can attach up to five files to a message, and each sheet of an Excel workbook counts as one file. Files can be up to 10 MB each, or 1.5 MB for text and Markdown files.

> [!NOTE]
>
> Attaching a file lets the Agent use it in that conversation. It doesn't connect the file as a data source for your organization.

## How the Agent handles actions

* **Activations and exports.** The Agent drafts the activation, shows its settings and billing impact, and waits for you to confirm or edit it. In the side panel, you review and submit it yourself.
* **Repeating schedules.** The Agent shows a proposal, and you create the schedule from it.
* **One-time reminders.** Once your connected data is ready for analysis, the Agent can create these right away, with an option to undo.
* **Search edits.** The Agent drafts the change and runs the search only when you ask.
* **Other changes.** Saving, renaming or scoring a segment, and other changes you ask for, happen right away.

## Find earlier chats

Select **History** and use **Search chats...** to find a conversation. You can pin chats you use often and archive the ones you no longer need. Archived chats aren't deleted, and you can unarchive them later.

## Limits and billing

Chatting, analyzing data and creating reports don't use your record export allowance. An activation or export the Agent starts for you is billed the same way as one you start yourself, and the same limits apply.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.