# Assistente de logs

Pergunte ao assistente o que aconteceu na cidade, quem fez o quê e quando; ele procura nos logs, mostra os resultados e abre no painel.

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

O **Assistente de logs** é um investigador que conhece o arquivo da cidade de cor. Você pergunta em português, como perguntaria para alguém da staff ("quem morreu hoje perto da praça?", "o que o passaporte 1042 fez ontem?"), e ele procura nos logs, mostra os logs que achou e abre a página certa no painel. Esta página é para a staff que investiga denúncias e acompanha o servidor.

## Antes de começar

* **FiveDash IA no plano:** o assistente precisa da FiveDash IA no plano da organização. Sem ela, aparece "A FiveDash IA não está no plano da organização. Adicione a IA em Configurações → Plano." Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing).
* **Logs ativos:** a configuração dos logs precisa estar concluída. Antes disso, o botão não aparece.
* **Nível de acesso:** **Ver** em **Todos os logs** ou em algum log. O assistente só lê os logs que você pode abrir.

## Abrir o assistente

### Vá para os logs

Abra qualquer página do módulo: **Logs → Visão geral**, **Logs → Todos os logs** ou um log.

### Abra o painel do assistente

No topo da página, clique em **Assistente**. O painel abre ao lado (no celular, embaixo).

### Pergunte

Escreva em **Pergunte sobre os logs da cidade…** e envie, ou clique numa das ideias prontas.

### Ideias prontas

| Ideia                                     | O que o assistente faz                                                       |
| ----------------------------------------- | ---------------------------------------------------------------------------- |
| **O que aconteceu nas últimas 24 horas?** | Resume os logs das últimas 24 horas e o que chama atenção.                   |
| **Investigar um jogador**                 | Pergunta o ID do jogador e mostra tudo o que ele fez nos logs.               |
| **Procurar mortes de hoje**               | Mostra as mortes de hoje e quem mais matou.                                  |
| **Criar um log novo**                     | Pergunta o nome e para que serve o log, cria e mostra como mandar do script. |
| **Algum log parou de chegar?**            | Lista os logs do servidor e quais estão em silêncio.                         |

## O que ele consegue fazer

O assistente usa ferramentas do painel. Enquanto trabalha, você vê cada passo (por exemplo, "Procurando “fuzil”" e depois "Procurou “fuzil”"), e os resultados aparecem como cartões com botão **Abrir**.

| Ação                                                           | Exemplo do que aparece                                              | Quem pode                                                              |
| -------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Ler a visão geral                                              | **Lendo os logs da cidade**                                         | Quem vê algum log                                                      |
| Buscar nos logs (texto, jogador, script, log, período, testes) | **Procurando nos logs**, com **Ver no explorador**                  | Quem vê algum log                                                      |
| Abrir um log inteiro                                           | **Abrindo o log**, com **Abrir o log**                              | Quem vê o log                                                          |
| Seguir um jogador                                              | **Seguindo o jogador …**                                            | Quem vê algum log                                                      |
| Ver os logs do servidor e os scripts                           | **Olhando os logs do servidor**, **Olhando os scripts e jogadores** | Quem vê algum log                                                      |
| Abrir uma página no painel                                     | **Abrindo no painel**                                               | Quem vê algum log                                                      |
| Criar um log                                                   | **Criando o log …**                                                 | **Todos os logs** em **Configurar** ou **Criar logs** em **Gerenciar** |
| Editar um log (nome, ícone, chave, como manda)                 | **Editando …**                                                      | **Configurar** no log                                                  |
| Gerar um link novo                                             | **Gerando um link novo para …** (pede confirmação)                  | **Configurar** no log                                                  |
| Excluir um log                                                 | **Excluindo …** (pede confirmação)                                  | **Configurar** no log                                                  |
| Mandar um log de teste                                         | **Mandando um teste para …**                                        | **Configurar** no log                                                  |

> Gerar um link novo e excluir um log sempre mostram um cartão de confirmação (**Confirmar esta ação?**). Nada acontece até você clicar em **Confirmar**.

## O que ele sabe

* **A página aberta:** o assistente sabe em que página de Logs você está, os filtros e o log aberto. Em cima da caixa de mensagem aparece o que ele está usando (como **Todos os logs** ou **Jogador 1042**). Clique no X do item (**Não usar …**) para ele ignorar.
* **Horários:** os horários são do horário de Brasília.
* **Seus acessos:** ele só vê e muda o que o seu acesso permite. Um log que você não vê não existe para ele.

## Anexos

Clique em **Anexar imagem, PDF ou texto** ou arraste o arquivo para a caixa.

| Tipo                                | Tamanho máximo |
| ----------------------------------- | -------------- |
| Imagens                             | 15 MB          |
| PDFs                                | 2 MB           |
| Arquivos de texto (.txt, .md, .csv) | 200 KB         |

Até 4 arquivos por mensagem. Documentos do Word: exporte como PDF.

## Conversas

As conversas ficam salvas neste navegador. Em **Conversas**, você busca, fixa, renomeia e apaga conversas. **Nova conversa** começa do zero.

## Limites

| Limite                          | O que acontece                                                 |
| ------------------------------- | -------------------------------------------------------------- |
| Muitas mensagens em pouco tempo | "Muitas mensagens seguidas. Espere um minuto e tente de novo." |
| Conversa grande demais          | "A conversa ficou grande demais. Comece uma nova."             |
| Logs ainda não configurados     | "Termine a configuração dos logs primeiro."                    |

> A IA pode errar. Confira nos logs antes de punir alguém.

## Perguntas frequentes

**O assistente vê os logs de todos os servidores da organização?**
Não. Ele trabalha no servidor aberto e só com os logs que você pode abrir.

**Posso pedir para ele criar um log e já me dar o código?**
Sim, se você pode criar logs. Ele cria o log e mostra a chamada do export ou o link do webhook (o link só aparece para quem configura o log).

**Ele pune ou bane alguém?**
Não. O assistente só lê os logs e cuida dos logs do FiveDash. As punições ficam com a staff.

## Próximos passos

[Buscar e filtrar](https://fivedash.fivex.gg/docs/pt/logs/search-and-filter)Investigue com os filtros do explorador.
[Criar logs](https://fivedash.fivex.gg/docs/pt/logs/create-logs)Configure os logs à mão.
[Assistente do painel](https://fivedash.fivex.gg/docs/pt/dashboard/assistant)Como o assistente funciona nos outros módulos.
[Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing)Adicione a FiveDash IA ao plano.
