# FiveDash IA

O que a FiveDash IA faz, onde aparece no painel, como usar os assistentes e em quais planos ela está disponível.

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

A **FiveDash IA** é o adicional de inteligência artificial do FiveDash. Ela tem duas partes: a **atendente IA**, que responde os tickets do Discord no lugar da equipe e chama alguém quando precisa, e os **assistentes**, que trabalham com você dentro do painel na **Loja**, nos **Logs** e nas **Regras**: respondem perguntas, buscam dados, abrem páginas e fazem mudanças com o seu ok.

## Antes de começar

* **Plano**: a FiveDash IA é um adicional de R$ 69,90/mês, um por organização, em qualquer nível. No teste grátis ela vem liberada (**Grátis no teste**). Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing).
* **Acesso**: o assistente de cada módulo só aparece para quem tem acesso a alguma página daquele módulo no servidor, e só faz o que o seu nível permite.
* **Módulo configurado**: o botão **Assistente** aparece depois que a Loja ou os Logs do servidor estão configurados.

> Sem a IA no plano, aparece **A FiveDash IA não está no plano da organização. Adicione a IA em Configurações → Plano.** Em **Configurações → Plano**, a linha da IA mostra **Contratada**, **No teste** ou **Não contratada**.

## Onde a IA aparece

| Onde                  | Como abrir                             | Nome                                |
| --------------------- | -------------------------------------- | ----------------------------------- |
| Páginas da **Loja**   | Botão **Assistente** no topo da página | **Assistente da loja**              |
| Páginas dos **Logs**  | Botão **Assistente** no topo da página | **Assistente de logs**              |
| Editor das **Regras** | Botão **Assistente** do próprio editor | **Assistente de regras**            |
| **Discord → Tickets** | Aba **Atendente IA**                   | A atendente que responde os tickets |

O assistente abre num painel ao lado da página (no celular, numa folha que sobe). Clique de novo em **Assistente** para fechar.

## O que cada assistente faz

| Assistente | Para quem pode mudar                                                                                       | Para quem só vê                                                                          |
| ---------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Loja**   | Pergunte sobre vendas, pedidos e clientes, ou peça para criar produtos, cupons, ofertas e mexer no site.   | Pergunte sobre vendas, pedidos e clientes. Eu busco, mostro e abro as páginas para você. |
| **Logs**   | Pergunte o que aconteceu, quem fez o quê e quando. Eu procuro nos logs, mostro e abro no painel para você. | O mesmo, sem mudanças                                                                    |
| **Regras** | Eu escrevo, reviso e organizo as páginas. Tudo vira rascunho até você publicar.                            | Eu leio as páginas, explico e sugiro mudanças para a equipe.                             |

### O que eles conseguem fazer

| Assistente | Consultar                                                                                               | Mudar (se o seu nível permitir)                                                                                                                                                                                                                                                                                                                                                                    |
| ---------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Loja**   | Números da loja, catálogo, produtos, cupons, ofertas, pedidos, clientes, site, crédito e afiliados      | Criar, editar, duplicar, ordenar e excluir produtos e categorias; trocar a imagem de um produto; criar, ligar, desligar e excluir cupons e ofertas; ajustar os mais vendidos; editar e publicar o site; anotar e marcar pedidos como entregues, reenviar entregas; anotar e bloquear clientes; dar um produto de presente; ajustar crédito e cashback; cuidar de afiliados, do programa e de bônus |
| **Logs**   | Visão geral, busca nos logs, um log específico, a atividade de um jogador, a lista de logs e os filtros | Criar, editar e excluir logs, trocar o link do webhook e mandar um log de teste                                                                                                                                                                                                                                                                                                                    |
| **Regras** | Listar, ler e buscar páginas                                                                            | Criar, reescrever, editar, mover e excluir páginas, renomear grupos e publicar o site                                                                                                                                                                                                                                                                                                              |

O assistente também abre a página certa do painel para você conferir o resultado.

## Confirmação antes de mudanças sérias

Antes de excluir algo ou publicar, o assistente para e pede o seu ok: **Confirmar esta ação?** · **O assistente quer fazer uma mudança que precisa do seu ok.** Clique em **Confirmar** ou **Cancelar**. Nas Regras, por exemplo, aparecem **Excluir “…”?** e **Publicar o site agora?**.

> A IA pode errar. Confira as mudanças na loja, confira nos logs antes de punir alguém e revise as páginas antes de publicar.

## Usar o assistente

### Abra o assistente

Numa página da Loja ou dos Logs, clique em **Assistente** no topo. Nas Regras, use o botão do editor.

### Peça ou pergunte

Escreva em **Mensagem para o assistente** e clique em **Enviar**. Ou escolha uma das ideias prontas, como **O que aconteceu nas últimas 24 horas?** (Logs) ou **Criar a página de punições** (Regras).

### Responda as perguntas dele

Se o assistente precisar de algo, ele mostra **O assistente quer saber** com opções. Escolha, use **Outra resposta** ou **Pular**.

### Confirme as mudanças

Quando ele quiser mudar algo sério, clique em **Confirmar** ou **Cancelar**. Use **Parar** para interromper uma resposta.

### Anexos

Clique em **Anexar imagem, PDF ou texto** ou arraste o arquivo para o painel (**Solte para anexar**).

| Tipo                                      | Tamanho máximo |
| ----------------------------------------- | -------------- |
| Imagens                                   | 15 MB          |
| PDF                                       | 2 MB           |
| Arquivos de texto (`.txt`, `.md`, `.csv`) | 200 KB         |
| Arquivos por mensagem                     | 4              |

Documentos do Word não entram: exporte como PDF.

### Atalhos nas perguntas do assistente

| Tecla         | O que faz                      |
| ------------- | ------------------------------ |
| **1** a **9** | Escolhe a opção daquele número |
| Setas         | Movem entre as opções          |
| **Enter**     | Envia                          |
| **Esc**       | Pula a pergunta                |

### Conversas

| Ação                              | Onde                         | O que faz                                                                                    |
| --------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------- |
| **Nova conversa**                 | Topo do assistente           | Começa do zero                                                                               |
| **Conversas**                     | Topo do assistente           | Abre o histórico, em **Fixadas**, **Hoje**, **Ontem**, **Últimos 7 dias** e **Mais antigas** |
| **Buscar conversas**              | Histórico                    | Procura pelo texto                                                                           |
| **Fixar no topo** / **Desafixar** | Menu da conversa             | Deixa a conversa sempre em cima                                                              |
| **Renomear**                      | Menu da conversa             | Muda o nome                                                                                  |
| **Excluir** / **Apagar todas**    | Menu da conversa / histórico | Apaga uma ou todas                                                                           |

> As conversas ficam salvas **neste navegador**. Em outro navegador ou aparelho, o histórico começa vazio.

## A atendente IA dos tickets

Em **Discord → Tickets → Atendente IA**, você liga a atendente, dá um nome, escolhe o jeito de falar (**Amigável**, **Profissional** ou **Descontraído**), escreve instruções da equipe, define o que ela sabe e quando ela chama a equipe. Ela sempre diz que é uma assistente virtual. Para funcionar, o bot precisa da **Message Content Intent** ligada no Discord Developer Portal. Todos os detalhes em [Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets).

## Mensagens de erro

| Mensagem                                                                   | O que fazer                                 |
| -------------------------------------------------------------------------- | ------------------------------------------- |
| **Não deu para falar com o assistente agora. Tente de novo em instantes.** | Clique em **Tentar de novo**                |
| **Sem conexão com o servidor. Confira a internet e tente de novo.**        | Confira a sua conexão                       |
| **A conversa ficou grande demais. Comece uma nova.**                       | Clique em **Nova conversa**                 |
| **Muitas mensagens seguidas. Espere um minuto e tente de novo.**           | Espere um minuto                            |
| **Seu acesso não permite usar o assistente neste servidor.**               | Peça acesso ao módulo para um dono ou admin |

## Perguntas frequentes

**A IA mexe em coisas que eu não posso mexer?** Não. Cada ação só é oferecida para quem tem a página e o nível certos, e o painel confere de novo antes de fazer.

**Em que idioma o assistente responde?** No idioma do seu painel. Veja [Idioma](https://fivedash.fivex.gg/docs/pt/dashboard/language).

**Posso usar a IA só no teste?** Sim, ela vem liberada nos 7 dias. Para manter depois, adicione a IA ao plano.

## Próximos passos

[Assistente de logs](https://fivedash.fivex.gg/docs/pt/logs/assistant)

Investigar o que aconteceu na cidade.

[Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets)

Configurar a atendente IA.

[Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing)

Adicionar a IA ao plano.

[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)

O que cada pessoa pode pedir.
