SuperAPI AI 工具集

ae-freeze-inactive-dashboards

数据与分析

查看项目

更新于 10-16 04:48

技能介绍

该技能用于识别并冻结长期无人访问的看板,基于审计项目中的 dashboard_search 事件数据进行判断。

用途 自动找出过去指定天数(默认 30 天,可配置为 60/90 天)内查询次数低于阈值(默认 1)的看板,并在用户确认后执行冻结。默认行为是冻结而非删除。

主要能力

  • 通过 dashboard_search 事件统计各看板的查询次数。
  • 可配置参数包括 INACTIVE_DAYS(默认 30)、TARGET_PROJECT(默认当前对话项目)、AUDIT_PROJECT(需用户指定或从项目列表中识别)、MIN_QUERY_COUNT(默认 1)、OUTPUT_FORMAT(table/json/csv)。
  • 输出分为不活跃候选表、活跃看板汇总行、已删除看板表三部分;不活跃表按查询次数升序排列。

使用方式

  • 仅使用 ae-cli,不使用其他 HTTP 端点或外部工具。
  • 执行前需满足 PROJECT_ID_GATE:通过 ae-cli team +list-projects 确认目标项目与审计项目;若审计项目未找到则立即停止,区分“无权限(联系管理员)”与“未部署(联系 CSM)”两种情况。
  • 步骤包括:检索全部看板(分页合并)→ 在审计项目中查询看板活动 → 计算不活跃集合与已删除集合 → 输出结果并确认冻结意图 → 对确认目标调用 dashboard get 检查状态 → 最终确认后执行冻结。
  • 冻结命令为:ae-cli analysis dashboard freeze --project-id <TARGET_PROJECT_ID> --dashboard-ids '[<id1>, <id2>, ...]' --freeze true。

适用场景

  • 需要清理或冻结长期无人使用的分析看板。
  • 需要基于真实访问数据(而非更新时间等代理指标)判断看板活跃度。

限制

  • 分析查询必须在审计项目中运行,而非目标项目。
  • 不得猜测 project_id、dashboard_id 或 project_name,必须通过 API 获取。
  • 任何写操作前必须展示候选并获得用户明确确认;不活跃候选的 dashboard get 调用是惰性的,仅在用户确认后才执行。
  • 不活跃集合中不得包含已冻结或已删除的看板。
  • 若审计项目无 dashboard_search 数据,则警告并将全部看板视为候选。
  • 若 INACTIVE_DAYS 超出审计数据历史范围,需警告数据范围限制。
  • 具体平台、收费、价格等信息暂未提供。