该技能用于分析、构建、修改和解释 Mixpanel 仪表盘,按用户意图分为四种模式:Analyze(读取结构、执行报表、总结)、Build(调研数据、规划、创建布局)、Modify(读取现状、规划变更、执行)、Explain(分析并生成数据驱动的文本卡片)。
主要能力包括:读取仪表盘布局与内容,区分 report、report-link、text 单元格;获取书签参数并执行已保存报表(insights、funnels、retention、flows)得到 DataFrame;跨报表关联指标;创建新仪表盘并设置行与单元格布局;更新现有仪表盘(元数据、单元格增删改、行排序);插入解释性文本卡片;固定或收藏仪表盘。
使用方式基于 Python 的 mixpanel_headless 模块,通过 Workspace 对象调用 get_dashboard、query_saved_report、query_saved_flows、create_dashboard、update_dashboard、pin_dashboard 等方法。文本卡片字段名为 markdown 但只接受 HTML,需去除换行并压缩空白。
限制与注意事项:仪表盘默认对团队不可见,创建后需调用 pin_dashboard;标题上限 255 字符、描述 400 字符、文本卡片 2000 字符、每行最多 4 项、最多 30 行;更新操作需按元数据、单元格创建、行排序、单元格更新、单元格删除、行删除的顺序执行;跨类型更新需先删除再创建;report-link 为只读;per_user 聚合需提供 math_property;布局 PATCH 不应包含 version。具体 API 细节与模板见其 references 目录下的参考文档。