使用手册 · 效率
报告
生成、下载和定时调度运营报告，涵盖成本摘要、Agent 健康状态和审计轨迹。
/reports概述#
报告页面可以从 ClawButler 数据中按需生成运营报告。报告汇总 Agent、成本和审计事件的信息，生成可下载的文档。
支持的报告类型包括成本摘要、Agent 健康快照和审计轨迹摘要。导出格式支持 CSV（用于数据分析）和 PDF（用于分享给相关方）。
前置条件#
前置条件
- 所需报告类型有足够的数据（例如，成本摘要需要成本记录）
- 拥有访问报告所含数据的相应权限
使用反馈#
报告页面提供完整的报告管理流程：
- -报告列表，显示已生成报告的状态、类型、日期范围和下载链接
- -生成状态指示器（排队中、处理中、已完成、失败），带进度追踪
- -已完成报告的 CSV 和 PDF 格式下载链接
Web 端操作#
报告页面围绕四个关键流程组织：浏览已有报告、生成新报告、下载结果和管理定时报告。
报告列表
主视图以表格形式展示所有已生成的报告，包含报告名称、类型、日期范围、状态和创建日期列。可按报告类型或状态筛选，快速定位特定报告。
生成报告
点击「生成报告」按钮创建新报告。选择报告类型（成本摘要、Agent 健康或审计摘要），设定日期范围，可选按特定 Agent 或类别筛选。报告在后台生成。
下载和导出
报告完成后，选择你需要的格式下载。CSV 导出包含原始表格数据，适合导入电子表格和数据工具。PDF 导出包含带图表的格式化摘要，适合分享。
定时报告
设置按天、周或月的周期性报告生成。定时报告自动生成并存储在报告列表中。可配置邮件投递，直接在收件箱中接收报告。
CLI 端操作#
列出所有已生成的报告及其状态和元数据
Terminal
$ ap report list指定类型和日期范围，生成新报告
Terminal
$ ap report generate --type cost-summary --range 30d将已完成的报告以指定格式下载到本地文件
Terminal
$ ap report export <id> --format pdf --output ./report.pdf常见问题#
问：生成一份报告需要多长时间？
答：大多数报告在几秒内完成。覆盖较长时间段或包含大量 Agent 的报告可能需要一分钟。你可以离开页面稍后返回，报告会在后台继续生成。
问：CSV 和 PDF 导出有什么区别？
答：CSV 导出包含表格格式的原始数据，适合导入电子表格或数据分析工具。PDF 导出包含带可视化图表的格式化摘要，适合分享给团队成员或相关方。
问：可以设置自动生成报告吗？
答：可以。在定时报告标签页中，可以配置按天、周或月的周期性生成。每个定时报告使用与手动报告相同的参数，完成后自动存储在报告列表中。