使用手册 · 洞察
数据分析
通过交互式仪表盘追踪 Agent 活动模式、工具使用频率和成本趋势。
/analytics概述#
数据分析页面为你的 Agent 生态系统提供全面的指标仪表盘。查看汇总使用数据、识别活动模式、监控成本趋势。
指标卡片提供概览摘要，交互式图表和使用量表格可深入查看特定 Agent、工具和时间段的详细数据。
前置条件#
前置条件
- 至少有一个活跃的 Agent 正在产生使用数据
- 已从连接的实例同步成本数据
使用反馈#
当 Agent 产生活动数据后，数据分析页面将显示：
- -指标卡片，展示所选时段内的总请求数、活跃 Agent 数、工具调用次数和成本总计
- -交互式图表，可视化活动趋势、成本分布和使用量分布
- -使用量表格，支持按列排序，提供按 Agent 和按工具的明细
Web 端操作#
数据分析页面分为三个主要区域：摘要卡片、趋势图表和明细表格。
概览仪表盘
顶部区域显示关键指标卡片：总请求数、活跃 Agent 数、工具调用次数和总成本。每张卡片展示当前值，以及与上一周期的对比变化。
时间范围选择
使用时间范围选择器在预设周期（24小时、7天、30天、90天）之间切换，或自定义日期范围。所有指标卡片、图表和表格都会更新以反映所选窗口。
指标详情
图表下方的使用量表格提供细粒度数据。按任意列排序以找到最活跃的 Agent 或最常用的工具。点击行可跳转到该 Agent 或工具的详情页。
CLI 端操作#
显示当前组织的分析指标摘要
Terminal
$ ap analytics overview查看指定 Agent 的使用分析
Terminal
$ ap analytics agent <id>列出所有 Agent 中使用频率最高的工具
Terminal
$ ap analytics tools --top 10常见问题#
问：为什么我的分析指标显示为零？
答：分析数据需要 Agent 正在处理请求。请确认你的 Agent 处于在线状态且连接器已完成同步。新数据通常在 Agent 活动后几分钟内出现。
问：可以导出分析数据吗？
答：可以。使用报告页面从分析数据生成可导出的报告。CLI 也支持使用 --json 参数以 JSON 格式导出分析结果。
问：分析数据可以追溯多久？
答：分析数据的保留期限取决于你的计划。免费版保留 30 天数据，Pro 版保留最多 1 年。你可以在保留窗口内查询任意时间范围。