SuperAPI AI 工具集

audit-project-usage-analysis

通用与其它

查看项目

更新于 10-16 08:43

技能介绍

用途:针对明确确认名为“审计项目”的 AE 项目,分析其跟踪事件,统计用户行为、给用户打标签并评估模块价值,交付“按人统计+模块价值评估”报告。触发语如“审计项目使用分析”“审计项目用得怎么样”;目标未确认前需先确认。

主要能力:按账号统计分析/运营/agent 三模块使用量并打标签(深度使用、查看者、运营任务、数据导出);评估 engage(需单独购买)与 agent(6.0+)模块是否被采用;将用户关注报表映射到业务主题;按动作量对项目排名并列出核心成员与热门报表。

使用方式:仅通过 ae-cli 查询,先加载 ae-analysis 技能约定,全部使用 ae-cli analysis adhoc export,不手工构造 QP。项目 ID 通过 ae-cli project info list --query "审计" 动态解析;先查 ta_version 判断是否统计 agent 模块。共 6 个导出,分两批各 3 个并行提交以避免并发限制;中断后按输出文件是否已存在且非空跳过已完成导出。随后运行 python3 scripts/generate_report.py 并传入各 jsonl.gz 文件,可加 --top-n、--out-json、--feishu-xml。报告为中文 markdown,可选飞书 XML,可用 lark-cli docs +create/update 写入。

适用场景:客户成功/交付团队评估系统实际使用、功能采纳与业务关注点。

限制:engage 未购买或 agent 低于 6.0 时对应模块整体省略;agent 事件无项目字段,不参与项目维度;agent 行为不触发深度使用标签;若事件/字段名被自定义重命名需核对 references/event_classification.md 并同步脚本字典;分析导出为零账号或总动作量为 0 时应停止排查,而非输出空报告。