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

# Consultar dados

> Perguntas de lista, contagem e indicador usam a consulta da API, sem SQL.

Para “quais” e “quantos”, a KingLog expõe um motor de consulta. Ele não aceita SQL. A API valida o pedido e aplica a empresa, a permissão e o escopo da pessoa.

Entidades: `tasks`, `projects`, `clients`, `leads`, `crm_activities`, `helpdesk_tickets`, `sprints`, `sla_commitments`, `organizations`, `contacts`.

**1. Descubra o schema**

`POST /ai/query/describe`. Sem `entity`, lista todas. Com `entity`, detalha campos e operadores. O que a conta não pode ver volta como `access=forbidden`.

**2. Liste ou agregue**

`POST /ai/query/run` devolve registros. `POST /ai/query/aggregate` devolve contagem, soma, média, mínimo ou máximo.

**3. Ou peça um indicador pronto**

`POST /ai/query/metrics` lista as métricas. `POST /ai/query/metrics/compute` calcula uma delas e devolve a definição junto com o número.

Em campo de usuário, `"@me"` é a pessoa do JWT. O assistente usa as ferramentas `kinglog_discover_schema`, `kinglog_query_data`, `kinglog_aggregate_data` e `kinglog_metrics` por cima dessas rotas. O detalhe está em [Consultar dados no assistente](https://docs.kinglog.com.br/pages/ai/consultar).

Indicadores prontos: tarefas atrasadas, taxa de conclusão, carga por responsável, saúde dos projetos, leads parados, conversão do CRM, tickets abertos por prioridade e cumprimento de SLA.


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