# Logs assistant

Ask the assistant what happened in the city, who did what and when; it searches the logs, shows the results and opens them in the panel.

Source: https://fivedash.fivex.gg/docs/en/logs/assistant

The **Logs assistant** is an investigator who knows the city's archive by heart. You ask in plain words, like you'd ask someone on the staff ("who died near the square today?", "what did character 1042 do yesterday?"), and it searches the logs, shows the ones it found and opens the right page in the panel. This page is for the staff who look into reports and keep an eye on the server.

## Before you start

* **FiveDash AI in the plan:** the assistant needs FiveDash AI in the organization's plan. Without it, you see "FiveDash AI isn't in the organization's plan. Add the AI in Settings → Plan." See [Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing).
* **Logs on:** the logs setup must be finished. Until then, the button doesn't show.
* **Access level:** **View** on **All logs** or on some log. The assistant only reads the logs you can open.

## Open the assistant

### Go to the logs

Open any page of the module: **Logs → Overview**, **Logs → All logs** or a log.

### Open the assistant panel

At the top of the page, click **Assistant**. The panel opens beside the page (at the bottom on phones).

### Ask

Type in **Ask about the city's logs…** and send, or click one of the ready-made ideas.

### Ready-made ideas

| Idea                                    | What the assistant does                                                            |
| --------------------------------------- | ---------------------------------------------------------------------------------- |
| **What happened in the last 24 hours?** | Summarizes the last 24 hours of logs and what stands out.                          |
| **Investigate a player**                | Asks for the player's ID and shows everything they did in the logs.                |
| **Find today's deaths**                 | Shows today's deaths and who killed the most.                                      |
| **Create a new log**                    | Asks the log's name and purpose, creates it and shows how to send from the script. |
| **Has any log stopped arriving?**       | Lists the server's logs and which ones are silent.                                 |

## What it can do

The assistant uses the panel's tools. While it works, you see each step (for example, "Searching for “rifle”" and then "Searched for “rifle”"), and results show up as cards with an **Open** button.

| Action                                                     | Example of what shows                                                | Who can                                                        |
| ---------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- |
| Read the overview                                          | **Reading the city's logs**                                          | Anyone who sees a log                                          |
| Search the logs (text, player, script, log, period, tests) | **Searching the logs**, with **See in the explorer**                 | Anyone who sees a log                                          |
| Open a whole log                                           | **Opening the log**, with **Open the log**                           | Anyone who sees that log                                       |
| Follow a player                                            | **Following player …**                                               | Anyone who sees a log                                          |
| See the server's logs and scripts                          | **Looking at the server's logs**, **Looking at scripts and players** | Anyone who sees a log                                          |
| Open a page in the panel                                   | **Opening in the panel**                                             | Anyone who sees a log                                          |
| Create a log                                               | **Creating the log …**                                               | **All logs** at **Configure** or **Create logs** at **Manage** |
| Edit a log (name, icon, key, how it sends)                 | **Editing …**                                                        | **Configure** on the log                                       |
| Generate a new link                                        | **Generating a new link for …** (asks to confirm)                    | **Configure** on the log                                       |
| Delete a log                                               | **Deleting …** (asks to confirm)                                     | **Configure** on the log                                       |
| Send a test log                                            | **Sending a test to …**                                              | **Configure** on the log                                       |

> Generating a new link and deleting a log always show a confirmation card (**Confirm this action?**). Nothing happens until you click **Confirm**.

## What it knows

* **The open page:** the assistant knows which Logs page you're on, its filters and the open log. Above the message box you see what it's using (like **All logs** or **Player 1042**). Click the item's X (**Don't use …**) to make it ignore that.
* **Times:** times are in Brasília time.
* **Your access:** it only sees and changes what your access allows. A log you can't see doesn't exist for it.

## Attachments

Click **Attach an image, PDF or text** or drag the file into the box.

| Type                         | Max size |
| ---------------------------- | -------- |
| Images                       | 15 MB    |
| PDFs                         | 2 MB     |
| Text files (.txt, .md, .csv) | 200 KB   |

Up to 4 files per message. Word documents: export them as PDF.

## Chats

Chats are saved in this browser. In **Chats**, you search, pin, rename and delete chats. **New chat** starts from scratch.

## Limits

| Limit                             | What happens                                               |
| --------------------------------- | ---------------------------------------------------------- |
| Too many messages in a short time | "Too many messages in a row. Wait a minute and try again." |
| Conversation too long             | "The conversation got too long. Start a new one."          |
| Logs not set up yet               | "Finish setting up the logs first."                        |

> AI can make mistakes. Check the logs before punishing anyone.

## FAQ

**Does the assistant see the logs of every server in the organization?**
No. It works on the open server and only with the logs you can open.

**Can I ask it to create a log and give me the code?**
Yes, if you can create logs. It creates the log and shows the export call or the webhook link (the link only shows for people who configure the log).

**Does it punish or ban anyone?**
No. The assistant only reads the logs and manages FiveDash logs. Punishments stay with the staff.

## Next steps

[Search and filter](https://fivedash.fivex.gg/docs/en/logs/search-and-filter)Investigate with the explorer's filters.
[Create logs](https://fivedash.fivex.gg/docs/en/logs/create-logs)Set up logs by hand.
[Panel assistant](https://fivedash.fivex.gg/docs/en/dashboard/assistant)How the assistant works in other modules.
[Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing)Add FiveDash AI to the plan.
