# Relatórios Personalizados com Assistente de IA
Os relatórios do sistema respondem às perguntas mais comuns da operação. Mas toda imobiliária tem uma pergunta que nenhum relatório pronto responde — um cruzamento específico, um indicador próprio, um painel do jeito que a diretoria quer ver.
O **relatório personalizado** resolve isso dentro do próprio sistema: a imobiliária monta os blocos numa grade, com um assistente de IA ao lado para ajudar a armar e ajustar, e publica. O relatório ganha nome, ícone e endereço próprios, e passa a aparecer no menu como qualquer outro.
---
##### **Navegação no Módulo**
**Rotina:** Relatórios > **Relatórios Personalizados**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/pcersonalizados.gif)
A listagem mostra os relatórios já criados, quais estão publicados no menu e quanto da cota do plano está em uso.
**Atenção:** A tela exige a permissão de acesso aos relatórios personalizados. Criar, editar e excluir têm permissões próprias — quem só tem a de acesso consegue abrir a listagem e os relatórios, mas não alterar nada.
---
#### **Criar um relatório com IA a partir de outro relatório**
Não precisa vir até esta tela para começar. Na barra de filtros dos relatórios do menu **Relatórios** existe o botão **Criar relatório com IA**. Quando o relatório aberto não mostra o que você precisa, clique nele e descreva o que quer ver: o assistente abre pronto para montar um relatório novo.
O botão só aparece quando o plano da imobiliária inclui os Relatórios Personalizados e o seu usuário pode criar relatórios personalizados e conversar com os agentes de IA. Se ele não aparece para você, peça ao responsável pelo seu acesso.
Se a imobiliária já usou todos os relatórios publicados que o plano permite, o sistema avisa antes de abrir o assistente: tire um relatório do menu, exclua um que não usa mais ou contrate mais relatórios personalizados no plano.
---
##### **O que aparece quando o relatório está vazio**
Editor sem nenhum bloco oferece três caminhos:
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/B1Dimage.png)
| Opção | Descrição |
|---|
| **Escolher um modelo**
| Parte de um relatório pronto e ajusta o que precisar.
|
| **Adicionar bloco**
| Abre a galeria de blocos prontos, com busca por nome e assunto.
|
| **Pedir ao assistente**
| Descreve o relatório em português e deixa o assistente montar.
|
Na galeria de blocos também existe a opção **Bloco em branco**, para quem prefere configurar tudo à mão.
---
##### **Dar nome, ícone e endereço**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/jNeimage.png)
No alto do editor ficam os três campos que definem como o relatório aparece:
| Campo | Descrição |
|---|
| **Ícone**
| O ícone do item no menu.
|
| **Nome do relatório**
| O texto que aparece no menu e no topo da tela publicada. É ele que as pessoas vão procurar.
|
| **Endereço**
| O caminho da tela publicada, logo depois de `/v/report/custom/`. Aceita letras minúsculas, números e hífen.
|
O endereço acompanha o nome automaticamente até você editá-lo à mão. A partir daí ele para de seguir o nome e fica como você deixou.
---
##### **Definir os filtros da página**
Estes dois campos configuram o que **a tela publicada** mostra no topo — eles não filtram o editor:
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/SKiimage.png)
| Campo | Descrição |
|---|
| **Período de abertura**
| O recorte com que o relatório abre. Quem visualiza pode trocar depois.
|
| **Filtros compartilhados da página**
| As dimensões que aparecem como filtro no topo e valem para todos os blocos que as tiverem.
|
**Atenção:** Filtro compartilhado só afeta os blocos que trabalham com aquela dimensão. Um bloco que não tem a dimensão escolhida simplesmente ignora o filtro — não fica em branco nem dá erro.
---
##### **Trabalhar com o assistente**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/FDXimage.png)
O botão **Assistente** abre o chat ao lado da grade, sem fechar o relatório. Ele enxerga o que está aberto e trabalha sobre isso.
Durante o trabalho, o assistente mostra o que está fazendo:
| Ação | Descrição |
|---|
| **Consultando o catálogo de dados**
| Descobre quais conjuntos, medidas e dimensões existem.
|
| **Lendo o relatório aberto**
| Lê os blocos que já estão na grade.
|
| **Calculando os blocos**
| Roda a prévia com dados reais da imobiliária.
|
| **Montando o relatório**
| Aplica a mudança na grade.
|
Se você tiver um bloco selecionado ao abrir o assistente, ele entende que o pedido é sobre aquele bloco.
**Peça em português, do jeito que você falaria:** "quero ver os negócios ganhos por corretor nos últimos seis meses", "acrescenta uma coluna com o valor médio", "troca esse gráfico por uma tabela".
---
##### **Desfazer o que o assistente fez**
Sempre que o assistente altera a grade, aparece o botão **Desfazer**, que volta o relatório para como estava antes daquela alteração.
**Atenção:** O **Desfazer** some assim que você mexe na grade à mão. Ele desfaz a última mudança **do assistente**, não as suas — então, se for testar uma proposta, confira antes de começar a ajustar manualmente.
---
##### **Configurar um bloco à mão**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/XNbimage.png)
Clicando num bloco da grade, o painel lateral abre com o que ele mostra. Os campos mudam conforme o tipo de bloco, mas o miolo é sempre o mesmo:
| Campo | Descrição |
|---|
| **Conjunto de dados**
| De onde vêm os números — negócios, imóveis, contratos, e assim por diante.
|
| **Contar pela data**
| Qual data do registro é usada no recorte de período. Em branco, usa a data padrão do conjunto.
|
| **Medida**
| O que é calculado — quantidade, soma de valor, e assim por diante.
|
| **E também**
| Medidas adicionais no mesmo bloco.
|
| **Por**
| A dimensão que quebra o resultado. Em branco, o bloco mostra um número só.
|
| **Agrupar as datas por**
| Quando a quebra é por data, define se agrupa por dia, mês e assim por diante.
|
| **E por**
| Uma segunda quebra, para comparar duas dimensões no mesmo bloco.
|
| **Ordenar** e **Mostrar até**
| A ordem do resultado e quantas linhas aparecem.
|
| **Forma**
| Como o bloco é desenhado. As opções mudam conforme a dimensão escolhida.
|
Há ainda **Título do bloco** — em branco, usa o nome da medida — e a opção de **mostrar ou esconder o título**.
---
##### **Filtrar só um bloco**
Além dos filtros da página, cada bloco pode ter os seus. Clique em **filtro**, escolha a dimensão, a condição e o valor.
O campo de valor se adapta à dimensão: lista fechada vira seleção múltipla, usuário abre a busca de usuários, pessoa e imóvel abrem as buscas correspondentes. Dimensão sem lista fechada pede o código exato.
---
##### **Blocos de texto**
Nem todo bloco é número. Existe o bloco de **Texto**, para escrever a observação que acompanha o relatório — o comentário do mês, o alerta para quem lê, a explicação de um número fora da curva.
---
##### **Ações de cada bloco**
| Ação | Descrição |
|---|
| **Adicionar ao meu painel**
| Grava o relatório e põe aquele bloco no seu painel da tela Principal. Só você vê.
|
| **Duplicar este bloco**
| Cria uma cópia na grade, para partir dela e mudar só o que difere.
|
| **Remover este bloco**
| Tira o bloco do relatório.
|
Os blocos são arrastáveis e redimensionáveis dentro da grade.
---
##### **Conferir antes de publicar**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/r4Nimage.png)
O botão **Prévia** abre o relatório publicado em outra aba, exatamente como as pessoas vão ver.
**Atenção:** A **Prévia** só fica disponível depois que o relatório foi gravado e publicado. Antes disso o botão aparece desabilitado.
---
##### **Gravar e publicar**
**Gravar** salva o relatório e publica o item no menu.
Se algo estiver faltando, o painel lateral mostra a lista do que impede a gravação, item por item — um bloco sem conjunto de dados escolhido, por exemplo. Resolvidos os avisos, o botão grava normalmente.
---
##### **Cota do plano**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/VVqimage.png)
A listagem mostra quantos relatórios publicados o plano permite e quantos estão em uso.
**Atenção:** A cota conta **apenas os relatórios publicados**. Tirar um relatório do menu devolve a vaga sem apagar nada — o relatório continua existindo e pode ser publicado de novo depois.
---
##### **Gerenciar os relatórios criados**
Em cada linha da listagem:
| Ação | Descrição |
|---|
| **Editar**
| Abre o editor.
|
| **Duplicar**
| Cria uma cópia, útil para fazer a variação de um relatório que já funciona.
|
| **Tirar do menu / Publicar no menu**
| Liga e desliga o relatório sem apagá-lo.
|
| **Excluir**
| Apaga o relatório.
|
As mesmas ações de publicar e tirar do menu estão no menu de engrenagem dentro do editor, junto com **Ver definição técnica**, que mostra a configuração do relatório em formato técnico — útil para o suporte.
---
##### **Perguntas frequentes**
➜ **Preciso saber montar relatório para usar?** Não. O caminho mais curto é o **Criar com assistente**: descreva em português o que quer ver e revise o que ele montou. Os campos do painel lateral existem para quem quiser ajustar depois.
➜ **O assistente inventa número?** Não. Ele monta a configuração do bloco e manda o sistema calcular; os números vêm da base da imobiliária, como em qualquer outro relatório.
➜ **O que acontece se eu não gostar do que o assistente fez?** Use o **Desfazer**, que volta a grade para antes da última mudança dele. Lembrando que o botão some quando você mexe na grade à mão.
➜ **Quem vai ver o relatório que eu criar?** Ele entra no menu como qualquer outro relatório do sistema e segue as permissões de acesso. Para guardar um bloco só para você, use a opção **Adicionar ao meu painel**, que o põe no seu painel da tela Principal.
➜ **Atingi a cota do plano. Preciso excluir um relatório?** Não necessariamente. Tirar um relatório do menu já devolve a vaga, e ele continua salvo para ser publicado de novo quando você quiser.
➜ **Posso mudar o endereço do relatório depois de publicado?** Pode, mas quem tiver guardado o link antigo vai deixar de encontrá-lo. Se o relatório já estiver em uso pela equipe, avise antes de trocar.
➜ **Dá para partir de um relatório que já existe?** Sim, por dois caminhos: **Duplicar** na listagem, para copiar um relatório seu, ou **Escolher um modelo** no editor vazio, para partir de um relatório pronto do sistema.
➜ **O filtro do topo vale para todos os blocos?** Vale para todos os blocos que trabalham com aquela dimensão. Os demais ignoram o filtro e continuam mostrando o que mostravam.