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

# Query AI

A página **Query AI** (`/ai`) é uma interface de chat onde você conversa com uma IA para explorar seus dados. Você faz perguntas em linguagem natural e a IA gera e executa as consultas SQL automaticamente, exibindo o resultado em uma tabela ao lado.

Acesse em [https://app.analytics.synapside.com/ai >](https://app.analytics.synapside.com/ai)

<Frame>
  <img src="https://mintcdn.com/inapplet/JOtCNGlI-9FjfRvP/images/image-1.png?fit=max&auto=format&n=JOtCNGlI-9FjfRvP&q=85&s=f0af79141e0dbe7086bfc1f2e24b3a07" alt="Image" width="1652" height="977" data-path="images/image-1.png" />
</Frame>

## Como a página está organizada

A tela é dividida em dois painéis:

* **Esquerda**: exibe o resultado da última consulta executada
* **Direita**: o chat, onde você digita suas perguntas e acompanha as respostas

## Painel de resultados (esquerda)

Após a IA executar uma consulta, o resultado aparece aqui em duas visualizações acessíveis pelas abas:

* **Tabela**: os dados retornados organizados em linhas e colunas, com contador de resultados.
* **SQL**: a consulta gerada pela IA, com opção de copiar para a área de transferência.

Antes de qualquer pergunta, o painel mostra um estado vazio orientando o usuário a iniciar pelo chat.

## Chat com IA (direita)

### Fazendo perguntas

Digite sua pergunta no campo de texto no rodapé do chat e pressione **Enter** (ou clique no botão de envio). A IA responderá com uma breve descrição do resultado e a tabela será atualizada automaticamente.

Exemplos de perguntas:

> "Quantas pageviews tivemos nos últimos 7 dias?"
>
> "Qual dispositivo mais acessou o site ontem?"
>
> "Mostre os 10 usuários com mais sessões este mês."

Use **Shift+Enter** para inserir uma quebra de linha sem enviar.

### Refinando consultas

O chat mantém o contexto da conversa. Depois de receber um resultado, você pode pedir ajustes diretamente, sem reformular a pergunta do zero:

> "filtra apenas mobile"
>
> "agrupa por semana em vez de dia"
>
> "mostra só os últimos 30 dias"

A IA usa o SQL anterior como base e aplica a modificação solicitada.

### Correção automática de erros

Se uma consulta falhar, a IA exibe a mensagem de erro no chat com um botão **Corrigir automaticamente**. Ao clicar, ela tenta regenerar o SQL corrigido e re-executa a consulta sem que você precise refazer a pergunta.

## Como usar no dia a dia

* **Análises rápidas sem SQL**: Obtenha respostas pontuais sem envolver um time técnico.
* **Explorar os dados livremente**: Faça perguntas sucessivas refinando o resultado até chegar na informação que precisa.
* **Inspecionar o SQL gerado**: Acesse a aba SQL para entender ou reutilizar a consulta em outras ferramentas.