# 统计与 KPI API
SUMMARY: 统计端点、集群 KPI 以及面向 LLM 智能体的 tidy-long KPI 导出（CSV/JSON/XLSX）。

统计与 KPI API
Synapse 提供只读统计信息，涵盖智能体健康、API 用量、趋势与集群 KPI。所有端点均接受 MindKey（）或用户 JWT（）。
现有分析路由（见 WebUI 中的  页面）：
| 路由 | 用途 |
| --- | --- |
|  | 所有智能体概览（周期：） |
|  | 跨智能体对比 |
|  | 单个智能体的详细统计 |
|  | 健康评分 |
|  | 活动热力图 |
|  | 会话追踪器 |
|  | API 用量（全局） |
|  | 时间序列 |
|  | 聊天响应时间 |
|  | A2A 消息流 |
|  | 定时任务分析 |
|  ·  ·  ·  ·  ·  | 仪表盘聚合 |
GET /export/kpis
运维 KPI 的 tidy-long 导出（任务 7418541b）。数据的事实来源是  —— 导出层只做扁平化，本身不做任何测量。
[CODE BLOCK]
| 参数 | 取值 | 默认 |
| --- | --- | --- |
|  |  ·  ·  |  |
|  | –（智能体概览的时间窗） |  |
响应：
-  → 
-  → （RFC 4180、BOM、CRLF），以附件形式返回
-  → Excel 工作簿（单一工作表 ），以附件形式返回
tidy-long 列（所有格式相同）：
| 列 | 含义 |
| --- | --- |
|  | KPI 组：、、、、、、 |
|  | 扁平化后的指标路径（如 ） |
|  | 标量值（数字、文本，或当只有  承载数据时为 ） |
|  |  ·  ·  ·  |
|  | 导出生成的 ISO-8601 时间戳 |
|  |  中的来源函数 |
|  | 用于数组/深层对象的 JSON 载荷，否则为空 |
示例：
[CODE BLOCK]
WebUI 的  页面在「KPI export」区域以三个下载按钮（CSV/JSON/XLSX）呈现同一导出。