# API de estatísticas e KPI
SUMMARY: Endpoints de estatísticas, KPIs de frota e exportação tidy-long de KPIs (CSV/JSON/XLSX) para agentes LLM.

API de estatísticas e KPI
A Synapse expõe estatísticas somente leitura sobre a saúde dos agentes, uso da API, tendências e KPIs de frota. Todos os endpoints aceitam um MindKey () ou um JWT de usuário ().
Rotas de análise existentes (ver a página  na WebUI):
| Rota | Propósito |
| --- | --- |
|  | Visão geral de todos os agentes (período: ) |
|  | Comparação entre agentes |
|  | Estatísticas detalhadas de um agente |
|  | Pontuação de saúde |
|  | Mapa de calor de atividade |
|  | Rastreador de sessões |
|  | Uso da API (global) |
|  | Séries temporais |
|  | Tempos de resposta do chat |
|  | Fluxo de mensagens A2A |
|  | Analítica de crons |
|  ·  ·  ·  ·  ·  | Agregados do painel |
GET /export/kpis
Exportação tidy-long dos KPIs operacionais (task 7418541b). A fonte da verdade dos dados é  — a camada de exportação apenas achata, não mede nada por si.
[CODE BLOCK]
| Parâmetro | Valores | Padrão |
| --- | --- | --- |
|  |  ·  ·  |  |
|  | – (janela para a visão geral de agentes) |  |
Resposta:
-  → 
-  →  (RFC 4180, BOM, CRLF) como anexo
-  → pasta de trabalho Excel (planilha única ) como anexo
Colunas tidy-long (idênticas em todos os formatos):
| Coluna | Significado |
| --- | --- |
|  | Grupo de KPI: , , , , , ,  |
|  | Caminho de métrica achatado (ex. ) |
|  | Valor escalar (número, texto ou  quando só  carrega dados) |
|  |  ·  ·  ·  |
|  | Timestamp ISO-8601 de geração do export |
|  | Função de origem em  |
|  | Payload JSON para arrays/objetos profundos, caso contrário vazio |
Exemplo:
[CODE BLOCK]
A página  da WebUI renderiza o mesmo export como três botões de download (CSV/JSON/XLSX) na seção "KPI export".