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

# Valyu Agent reference

> Roles, context, limits, Slack permissions, data handling, updates and troubleshooting for Valyu Agent for Slack.

Hosted app: `https://slack.valyu.ai`

## Roles

| Role | Who | Can |
| - | - | - |
| Admin | Workspace admins, owners and primary owners | Connect Valyu, manage scheduled reports, and choose app managers |
| App manager | People that an admin chooses in the **Home** tab | Connect Valyu and manage scheduled reports |
| Everyone else | All members | Research. They cannot see or change the setup |

There are no app managers until an admin chooses them. The person who installs the app is not an admin unless their Slack role makes them one.

## Context

Valyu Agent uses:

* **The thread:** every message, as its memory, up to 200 messages. In a longer thread, it drops the oldest messages in blocks of 50.
* **The channel:** up to 50 messages before the thread, only when your question needs them.
* **Your files:** files in your message, and your own files from earlier in the thread when your question is about them.

Other people's messages are context for Valyu Agent, not instructions to it.

## Files

| Type | Maximum size |
| - | - |
| PDF, Word (`.docx`), PowerPoint (`.pptx`) | 50 MB |
| Excel (`.xlsx`), images (PNG, JPEG, GIF, WebP) | 20 MB |
| CSV, text, Markdown | 10 MB |

You can attach up to 10 files to one question, with a total of 25 MB. Valyu Agent can search the text of PDF, Word, PowerPoint, Excel, CSV, text and Markdown files.

## Limits

* Each person can run up to 3 research requests at the same time.
* `fast`, `standard`, `heavy` and `max` runs work in the background, and Valyu Agent posts the answer when the run ends.
* An `instant` answer waits up to about 3 minutes. After that, the run keeps going on the Valyu platform.
* A confirm card for a report change works once and expires after 30 minutes.

## Data handling

* Valyu Agent does not keep your files. It sends a file to DeepResearch with the request. When it searches a file, it keeps the text for 24 hours, then deletes it.
* The research task gets the end of the thread conversation as background.
* Valyu Agent stores the Valyu API key encrypted.
* In a channel, Valyu Agent sends the full list of scheduled reports only to the person who asked.
* See the [privacy policy](https://slack.valyu.ai/privacy) and the [terms](https://slack.valyu.ai/terms).

## Updates

Updates to Valyu Agent reach your workspace automatically. When an update needs a new Slack permission, admins and app managers see **Update available** at the top of the **Home** tab. Click **Update Valyu** and approve the permission once.

## Slack permissions

| Permission | Why Valyu Agent needs it |
| - | - |
| `app_mentions:read` | Receive messages that mention it |
| `chat:write` | Post answers, progress and reports |
| `channels:read`, `groups:read` | Make sure that it is in a channel before it starts research |
| `channels:history`, `groups:history` | Read its threads, and the channel messages before a thread when a question needs them |
| `im:history`, `im:read`, `im:write` | Talk with people in direct messages |
| `users:read` | Find who is an admin, and use your Slack time zone |
| `commands` | The `/valyu` command and the **Research this** shortcut |
| `files:read` | Read the files you attach |
| `files:write` | Attach reports, spreadsheets and slides |
| `reactions:write` | Show the status of your request on your message |
| `assistant:write` | Show progress and suggested prompts in direct messages |

## Troubleshooting

| Problem | What to do |
| - | - |
| "Valyu is not connected in this workspace yet" | An admin or app manager clicks **Connect Valyu** in the **Home** tab. |
| "I'm not in this channel yet" | Run `/invite @Valyu Agent` in the channel, then ask again. |
| **Update available** in the Home tab | Click **Update Valyu** and approve the permission. |
| "I can only reply in my own direct messages" | Use `/valyu` in a channel that Valyu Agent is in, or send it a direct message. |
| "I could not read" a file | Look at the type and size in [Files](#files). If the message asks for an update, an admin clicks **Update Valyu**. |
| No credits left | Add credits on [platform.valyu.ai](https://platform.valyu.ai). |
| A scheduled report did not arrive | Open the **Home** tab and read the error on the report. Select **Preview** in the report's menu to test it. |

## Resources

> **[Add to Slack](https://slack.valyu.ai/api/slack/install)**
>
> Install Valyu Agent in your workspace

> **[Get a Valyu API key](https://platform.valyu.ai)**
>
> Create or manage API keys

> **[Support](https://slack.valyu.ai/support)**
>
> Get help with the installation

> **[Hosted app](https://slack.valyu.ai/)**
>
> Open the Valyu Agent page


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