用途:核验留存分析模型的数据是否正确,诊断留存分析与事件分析结果不一致的原因,并解释两类模型统计逻辑的差异。适用于用户反馈留存数据异常、或留存与事件分析对不上数的场景。
主要能力:以 ae-cli 为主工具查询数据,连接器仅作兜底;可组合留存模型定义并执行 adhoc 查询,直接读取报表数据获取实际日期与数值,核验留存率=回访用户数÷初始用户数;可读取事件分析报表配置,诊断指标类型、人群过滤、时间范围、公式等配置问题;输出分五部分的核验结果(模型统计差异、配置差异、正确的事件分析验证配置、数据核验、总结),并在最后要求用户确认时区。
使用方式:先读取 ae-analysis 技能目录下对应的 references/<tool_name>.md,再组合命令。CLI 参数用 kebab-case(如 --project-id、--model-type、--zone-offset),AI 面向的定义键用 snake_case(如 initial_event、return_event、unit_num),JSON 用单引号包裹。留存定义示例:ae-cli analysis adhoc run --project-id <project_id> --model-type retention --definition "$(cat /tmp/ae_retention_definition.json)" --zone-offset <REPORT_TZ>;报表数据查询:ae-cli analysis report-data run --project-id <project_id> --report-ids '[<report_id>]';报表配置查询:ae-cli analysis report get --project-id <project_id> --report-id <event_analysis_report_id>。
限制:禁止传原始 QP 或前端 DTO 字段;不得猜测命令名、参数、project_id 或资源 ID;时区必须取自报表定义并逐次传入,项目默认时区仅作兜底;事件分析诊断只查配置不查数据;ae-cli 反复因非参数原因失败或无对应能力时,应报告能力缺口或降级为框架级建议,不得使用已退役的 MCP 工具。具体价格、平台支持等信息暂未提供。