> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Queries
> Explore dados de sessão, evento e avaliação com SQL reutilizável.
Queries são a camada flexível por baixo de dashboards, auditorias e investigações. Use SQL ad-hoc para testar uma ideia e, quando ela se tornar parte de um fluxo recorrente, salve a query.
## Criar e executar uma query
1. Acesse **Analyze → Queries** e selecione **new query**.
2. Abra o navegador de schema e escolha campos dos dados de evento, sessão ou avaliação.
3. Escreva o SQL, adicione parâmetros quando necessário e execute a query.
4. Salve com um nome e descrição claros e use **add to dashboard** quando o resultado precisar ser monitorado.
O editor de queries combina o schema de eventos, SQL, parâmetros e uma prévia dos resultados para que você possa validar a questão antes de salvá-la.
As queries salvas aparecem na biblioteca compartilhada, onde os membros da equipe podem reexecutá-las ou adicionar seus resultados a dashboards.
Use um nome e descrição claros para que o resultado continue compreensível sem precisar reabrir o SQL.
```bash theme={null}
fp query schema
fp query create "retry loops" --sql "SELECT ..."
fp query run
fp query show
fp query update --sql "SELECT ..."
```
Use `fp query list` para encontrar IDs e `fp query delete ` para remover uma query salva.
## Usos comuns
* Encontrar sessões com chamadas repetidas à mesma ferramenta.
* Comparar pontuações de avaliação entre modelos ou ambientes.
* Medir o tempo entre uma espera humana e a retomada.
* Identificar negações de política seguidas de uma alternativa bem-sucedida.
* Construir uma coorte para auditoria.
Abra **Queries → Schema** antes de escrever consultas contra campos desconhecidos. Prefira filtros explícitos de tempo e ambiente, e mantenha limites de resultados durante a exploração.
Uma query pode identificar um padrão suspeito, mas não estabelece o modo de falha por si só. Abra traces representativos ou execute uma auditoria antes de transformar o resultado em uma política.