> ## 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.

# Perguntar ao agente

> Como fazer perguntas em português ao agente de um módulo sobre os dados do painel, a documentação pública da EcoTrust e a web, e receber respostas e cards no canvas.

Use este guia para tirar dúvidas e montar visualizações sem executar um serviço. O agente de cada módulo responde perguntas escritas em português e alcança três fontes, que você pode pedir na mesma pergunta:

* os **dados do seu painel**: ocorrências, ativos, execuções;
* a **documentação pública da EcoTrust**: guias, conceitos e referências do portal;
* a **web pública**: boletim de fabricante, catálogo de exploração, aviso de segurança, nota de versão.

Ao perguntar pelos indicadores do **Dashboard**, a resposta traz os mesmos números e rótulos que aparecem na tela, no recorte consultado.

No VulScan, você também pode pedir ocorrências por probabilidade EPSS, percentil, presença no catálogo CISA KEV, uso em ransomware ou exploit público e remoto. Pergunte pelas faixas SSVC para receber os mesmos totais e rótulos do Dashboard. No Flow, a pergunta pelas faixas SSVC usa os números do Dashboard desse módulo.

## Pré-requisitos

* Acesso ao painel e ao módulo. As perguntas são feitas na aba **Agent Work**.
* Um ambiente cadastrado na plataforma e o perfil **Gestor** ou **Analista** para baixar a licença do CONNECT.

## Baixar a licença do CONNECT

Você pode pedir a licença do CONNECT em uma conversa livre, sem iniciar um serviço nem seguir o roteiro de instalação.

**1. Pedir a licença**

No **Agent Work**, clique em **Nova** e peça para baixar a licença do CONNECT.

**2. Escolher o ambiente**

Escolha o ambiente no seletor que o agente mostra e clique em **Baixar licença**. O link para o arquivo `.key` vale por 1 hora.

Para colocar o arquivo na máquina e ativar o Connect, siga [Instalar o Connect](https://docs.ecotrust.io/connect/instalar.md).

## Perguntar sobre os dados do painel

**1. Abrir uma conversa**

No **Agent Work**, clique em **Nova**.

**2. Escrever a pergunta**

Escreva o que quer saber no campo de mensagem. Para receber o resultado como painel, e não como texto, peça que o agente **monte no canvas** e nomeie as colunas que precisa.

> [!NOTE]
>
> **Exemplo de pedido**
>
> Renderize no canvas um card com os 10 controles de CSPM com mais reprovações, mostrando o nome do controle, a severidade e a quantidade de recursos reprovados.

**3. Usar o card**

O card aparece no canvas, com um resumo do conjunto na linha abaixo do título.

![Card renderizado no canvas: título Controles CSPM com mais reprovações, o resumo em uma linha, e uma tabela com o controle, o selo de severidade e a quantidade de recursos reprovados, com barra proporcional.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/aw-01-card.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=b4d44edf2129ee424ba8fa2ac4431fc8)

O card no canvas. Você define as colunas no pedido; o agente resume o conjunto na linha abaixo do título.

**Controles do card, no topo do widget**

| Controle | O que faz |
| - | - |
| **Salvar como artefato** | Guarda o card na aba **Artefatos**, como um arquivo `.html` nomeado a partir do assunto. |
| **Referenciar no chat** | Usa o card como contexto da próxima mensagem, para pedir um recorte ou uma variação. |
| **Remover do canvas** | Tira o card da tela. O que já foi salvo em **Artefatos** permanece. |

## Consultar a documentação da EcoTrust

Pergunte diretamente sobre como usar um módulo, seus pré-requisitos ou o significado de uma informação da tela. O agente pesquisa primeiro as páginas do módulo em que você está e lê a página completa quando o trecho encontrado não basta.

No fim da resposta, o agente indica o link da página que usou. Abra-o para conferir o contexto ou seguir o passo a passo completo.

> [!TIP]
>
> O agente consulta somente a documentação pública. Se o portal não cobrir a pergunta, ele avisa em vez de completar a resposta com outra fonte.

## Pesquisar na web

Não há comando para isso: diga na pergunta que quer a busca na web. O agente anuncia que vai pesquisar, mostra cada busca como um passo **Pesquisando** com o termo usado, refina o termo quando o primeiro resultado é fraco, e fecha citando a fonte com o endereço.

![Conversa com duas buscas na web em sequência, cada uma como um passo Pesquisando, e a resposta final com a fonte primária e o endereço.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/60-web-consulta.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=731cb827b2fc799024903a45600672e2)

Duas buscas em sequência: a segunda foi feita porque a primeira trouxe números de agregadores. No fim, Fonte primária traz o endereço de onde a informação saiu.

A pergunta que mais rende junta as duas fontes: o agente consulta o painel para saber o que você tem, pesquisa na web o que se sabe sobre aquilo e devolve a leitura cruzada, com a tabela no canvas.

| Para que serve | Pergunta pronta para copiar |
| - | - |
| Separar o que já tem prova de conceito do que é só teórico | Pesquise na web se existe exploit público para as CVEs altas do meu painel e cruze com as minhas ocorrências. Cite a fonte. |
| Saber o que já foi usado em ataques reais | Pesquise no catálogo KEV da CISA se alguma CVE das minhas ocorrências está lá, e desde quando. |
| Achar a correção de uma falha | Procure na web o boletim do fabricante para a CVE que estou vendo e me diga se já existe correção publicada. |
| Cruzar a web com o seu parque | Busque na web as notas de versão deste produto e diga qual versão corrige as falhas que aparecem no meu painel. |

> [!TIP]
>
> Peça a fonte na própria pergunta: a resposta passa a trazer o endereço, e você confere antes de levar o dado para um relatório. Quando a fonte oficial e um agregador trouxerem números diferentes, diga qual quer usar (o NVD, o catálogo KEV da CISA, o aviso do fabricante).

## Verificar o resultado

A resposta aparece no fio da conversa, ou como card no canvas quando você pediu. Em uma análise longa, o agente conclui com o que já apurou, em vez de encerrar a conversa por atingir um limite.

Você pode avaliar a última resposta de cada turno e os cartões de relatório com o polegar para cima ou para baixo. O comentário é opcional. Depois de avaliar, os botões daquele resultado ficam indisponíveis.

As conversas ficam no **Histórico**, o ícone de relógio no cabeçalho do chat, e na aba **Observabilidade**. Quando você citar um card ou arquivo de outra conversa, o agente mostra as conversas recentes para você escolher a que quer abrir.

## Problemas comuns

> [accordion] O agente recusou responder à minha pergunta
>
> Reformule a pergunta para um objetivo defensivo, como priorizar controles, ou clique em **Nova** para abrir outra conversa. Reenviar o mesmo pedido na conversa atual pode levar a uma nova recusa.

## Próximos passos

* [Paleta de comandos](https://docs.ecotrust.io/ecotrust-os/paleta-de-comandos.md): os atalhos do campo de mensagem
* [Artefatos](https://docs.ecotrust.io/ecotrust-os/artefatos.md): guardar e baixar o que o agente produziu


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