# API di statistiche e KPI
SUMMARY: Endpoint di statistiche, KPI di flotta ed export tidy-long dei KPI (CSV/JSON/XLSX) per agenti LLM.

API di statistiche e KPI
Synapse espone statistiche di sola lettura su salute degli agenti, uso dell'API, tendenze e KPI di flotta. Tutti gli endpoint accettano un MindKey () o un JWT utente ().
Rotte di analisi esistenti (vedi la pagina  nella WebUI):
| Rotta | Scopo |
| --- | --- |
|  | Panoramica di tutti gli agenti (periodo: ) |
|  | Confronto tra agenti |
|  | Statistiche dettagliate di un agente |
|  | Punteggio di salute |
|  | Mappa di calore dell'attività |
|  | Tracciamento delle sessioni |
|  | Uso dell'API (globale) |
|  | Serie temporali |
|  | Tempi di risposta della chat |
|  | Flusso dei messaggi A2A |
|  | Analitica dei cron |
|  ·  ·  ·  ·  ·  | Aggregati del cruscotto |
GET /export/kpis
Export tidy-long dei KPI operativi (task 7418541b). La fonte di verità dei dati è  — il layer di export appiattisce soltanto, non misura nulla da sé.
[CODE BLOCK]
| Parametro | Valori | Predefinito |
| --- | --- | --- |
|  |  ·  ·  |  |
|  | – (finestra per la panoramica agenti) |  |
Risposta:
-  → 
-  →  (RFC 4180, BOM, CRLF) come allegato
-  → cartella di lavoro Excel (foglio singolo ) come allegato
Colonne tidy-long (identiche in tutti i formati):
| Colonna | Significato |
| --- | --- |
|  | Gruppo KPI: , , , , , ,  |
|  | Percorso metrica appiattito (es. ) |
|  | Valore scalare (numero, testo o  quando solo  contiene dati) |
|  |  ·  ·  ·  |
|  | Timestamp ISO-8601 di generazione dell'export |
|  | Funzione sorgente in  |
|  | Payload JSON per array/oggetti profondi, altrimenti vuoto |
Esempio:
[CODE BLOCK]
La pagina  della WebUI renderizza lo stesso export come tre pulsanti di download (CSV/JSON/XLSX) nella sezione "KPI export".