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

# Gerar um relatório de um módulo

> Como pedir ao agente o relatório de um módulo, escolher o tipo, o formato e o recorte, e receber o arquivo com os mesmos números do Dashboard e, quando a lista não cabe na página, um anexo CSV.

Use este guia para levar o Dashboard de um módulo para fora do painel, num relatório escrito para quem vai lê-lo. O relatório parte dos mesmos números que o Dashboard do módulo mostra, no recorte que você escolher: um ambiente, um grupo, um período. O menu **Novo artefato** e o download estão em [Gerar e baixar um artefato](https://docs.ecotrust.io/ecotrust-os/artefatos.md); esta página traz o que você pode pedir em cada módulo e o que vem no arquivo.

## Pré-requisitos

* Acesso ao painel e ao módulo, com dados já importados por uma execução.

## Passos

**1. Pedir o relatório**

No **Agent Work** do módulo, escreva o pedido no campo de mensagem. Você também pode clicar em **Novo artefato**, na aba **Artefatos**, que abre o **Agent Work** com o pedido já escrito.

Para receber o arquivo sem passar pelo formulário, diga no pedido o tipo, o formato e o recorte que quer.

No Flow e no Surface, você também pode pedir o relatório só das ocorrências que escolher: marque-as na lista de ocorrências e clique em **Gerar o relatório da seleção com IA**, na barra que aparece no pé. O relatório traz no máximo 500 ocorrências e diz na capa o recorte, como "a seleção de 12 ocorrências do Flow". Para uma seleção, o formulário não oferece o tipo **Executivo** nem o **Período**. Veja [Encontrar ocorrências no Flow](https://docs.ecotrust.io/modulos/flow/encontrar-ocorrencias.md) e [no Surface](https://docs.ecotrust.io/modulos/surface/encontrar-ocorrencias.md).

No Flow, o mesmo vale para as listas de **Ativos** e de **Grupos**: marque até 500 ativos ou grupos e gere o relatório deles com IA, ou baixe o CSV. O relatório traz os objetos marcados e as 500 ocorrências abertas mais graves deles. No chat do Flow, você também pode pedir o relatório de um ativo pelo nome; se o nome servir para mais de um ativo, o agente pergunta qual.

> [!NOTE]
>
> **Exemplo de pedido**
>
> Gere o relatório tático do Flow em PDF, só do ambiente Produção, dos últimos 90 dias.

**2. Escolher o tipo e o formato**

Quando o pedido não diz o tipo e o formato, o agente apresenta os tipos do módulo e abre o formulário com o **Tipo de Relatório** e o **Formato de Relatório**. Nos módulos que têm, o formulário traz também o **Período** ou a **Abrangência**, já marcados com o valor que o Dashboard usa. Escolha e clique em **Confirmar**.

Nos módulos que não oferecem o tipo **Executivo**, pedir um relatório executivo gera o relatório **Estratégico** do módulo, sem abrir esse seletor.

**Pular** cancela o pedido: nenhum relatório é gerado.

**3. Receber o arquivo**

O agente gera o arquivo com os dados atuais do módulo e mostra o cartão de download na conversa. Nenhuma linha do recorte fica de fora: o que não cabe na página vai para o anexo CSV. Em um relatório agrupado por aplicação com mais de 500 aplicações, o arquivo informa que o resultado é parcial. O relatório fica guardado na aba **Artefatos** do módulo.

## Os tipos de cada módulo

Todo tipo sai em qualquer um dos formatos: **PDF**, **DOCX (Word)**, **XLSX (Excel)**, **HTML (página única)** e **CSV**.

| Módulo | Tipos de relatório |
| - | - |
| VulScan | Operacional, Tático, Estratégico, ISO 27001, SSVC (Stakeholder-Specific Vulnerability Categorization) e Executivo |
| Surface e Verify | Operacional, Tático, Estratégico, ISO 27001 e Executivo |
| AutoPatch | Operacional, Tático e Estratégico |
| Radar, Inventory, AppSec, Baseline, Flow e Quantify | Operacional, Tático, Estratégico e ISO 27001 |

O tipo define o leitor:

* **Operacional**: para quem corrige. Cada item, com a ação de cada um.
* **Tático**: para coordenadores e gestores. O risco priorizado e o plano de remediação.
* **Estratégico**: para CISO e diretoria. A postura consolidada e as recomendações, em poucas páginas.
* **ISO 27001**: para quem prepara a auditoria, organizado pelos controles da norma.

Os três primeiros partem dos mesmos números: quem compara o Operacional, o Tático e o Estratégico do mesmo recorte vê documentos diferentes que concordam entre si. O **SSVC** e o **Executivo** são próprios dos módulos que os oferecem; veja [Gerar um relatório do VulScan](https://docs.ecotrust.io/modulos/vulscan/gerar-um-relatorio.md) e [Gerar um relatório do Surface](https://docs.ecotrust.io/modulos/surface/gerar-um-relatorio.md).

> [!NOTE]
>
> No Quantify, o relatório parte da simulação do próprio Dashboard, em R\$, e traz a tendência da perda esperada ao longo do tempo. O **Relatório FAIR para Board** é outro documento: ele é um serviço do **Catálogo de Serviços** do Quantify.

## Os recortes de cada módulo

Alguns recortes aparecem no formulário, já marcados com o valor do Dashboard. Os outros você pede na conversa, pelo nome, como a tela os escreve ("só do ambiente Produção", "só do grupo Servidores web").

| Módulo | No formulário | No pedido |
| - | - | - |
| Radar | Nenhum | Ambiente |
| Inventory | Nenhum | Ambiente |
| VulScan | **Período**, com todo o período por padrão | Ambiente |
| AppSec | **Período**, com todo o período por padrão | Ambiente |
| Baseline | **Abrangência**: **Todos** por padrão, ou um padrão | Ambiente, grupo e conta de nuvem |
| Flow | **Período**, com os últimos 30 dias por padrão, como a tela abre | Ambiente, grupo ou um ativo pelo nome |
| AutoPatch | **Período**, com todo o período por padrão | Nenhum |
| Verify | Nenhum | Portfólio |
| Surface e Quantify | Nenhum | Nenhum |

No Baseline, o relatório de uma conta de nuvem traz só a postura dessa conta, e o formulário deixa de mostrar a **Abrangência**.

## O que vem no arquivo

* **Os números do Dashboard.** O relatório lê o Dashboard do módulo como a tela o mostra, já calculado pela plataforma, e não reconta nada.
* **O número principal na capa.** No Radar, no Inventory, no VulScan, no AppSec, no Baseline, no Flow e no Quantify, a capa do Operacional, do Tático e do Estratégico abre com o número principal do Dashboard, como **Aderência ao baseline** no Baseline, igual nos três.
* **O recorte na capa.** Nesses mesmos relatórios, a capa diz o período e a abrangência aplicados e o recorte: um ambiente, um grupo, uma conta, ou todo o painel.
* **"Sem fonte" no lugar de zero.** Quando uma parte da plataforma não responde na hora da geração, o número que depende dela sai como "sem fonte", com o motivo, e nunca como zero ou lista vazia.
* **O anexo CSV.** Em PDF e em HTML, a página mostra no máximo 300 linhas: primeiro os quadros de resumo, depois as linhas de maior severidade, repartidas entre as listas da mesma severidade para que cada lista apareça, com os textos longos encurtados. As descrições são a exceção: saem inteiras, numa linha da largura da página logo abaixo da linha delas, como o contexto de cada CVE no relatório operacional do VulScan. O quadro diz o que ficou de fora, e a lista completa, com o texto inteiro, vem num anexo CSV entregue junto do relatório, com o mesmo nome terminado em `_anexo.csv`.

Os relatórios do AutoPatch, o Executivo e o SSVC seguem o modelo próprio do módulo e não trazem esse anexo. O Executivo do VulScan vem com a sua planilha de CVEs por ativo.

## Verificar o resultado

O cartão do relatório aparece na conversa e na grade da aba **Artefatos**, com o nome, quem gerou e quando. Para conferir os números, abra o Dashboard do módulo no mesmo recorte e compare com o número principal da capa: é o mesmo número.

## Problemas comuns

> [accordion] O agente diz que o ambiente, o grupo ou a conta não existe
>
> O nome pedido não bate com nenhum do painel. O agente lista os que existem: peça de novo com um deles, ou sem o recorte para o painel inteiro.

> [accordion] Um número saiu como sem fonte
>
> A parte da plataforma que calcula esse número não respondeu na hora da geração. Os números que não dependem dela saem normalmente. Gere o relatório de novo em alguns minutos.

> [accordion] O relatório diz que não há achados
>
> O recorte escolhido não tem ocorrências, e o relatório diz isso em vez de sair vazio. No AppSec, ele diz que não há achados de aplicação no período. Escolha um período maior ou outro recorte.

> [accordion] O PDF não traz todas as linhas
>
> A página mostra no máximo 300 linhas, e a lista completa está no anexo CSV entregue junto. Ele abre no Excel.

> [accordion] Pedi todas as ocorrências do Flow no relatório
>
> O relatório do Flow traz os rankings do Dashboard, e o agente sugere a exportação da lista. Para um relatório que liste cada ocorrência, marque até 500 na lista do Flow e use **Gerar o relatório da seleção com IA**. Para ter cada ocorrência numa planilha, use **Exportar CSV** em [Encontrar ocorrências](https://docs.ecotrust.io/modulos/flow/encontrar-ocorrencias.md), com o mesmo recorte.

> [accordion] O link que eu enviei parou de funcionar
>
> O link de download de um artefato é temporário. Para compartilhar um relatório, baixe o arquivo e envie o arquivo, não o endereço.

## Próximos passos

* [Gerar e baixar um artefato](https://docs.ecotrust.io/ecotrust-os/artefatos.md)
* [Perguntar ao agente](https://docs.ecotrust.io/ecotrust-os/perguntar-ao-agente.md): para ver um recorte na hora, como card no canvas
* [Paleta de comandos](https://docs.ecotrust.io/ecotrust-os/paleta-de-comandos.md)


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