SuperAPI AI 工具集

chart-link-analysis

数据与分析

查看项目

更新于 10-15 19:56

技能介绍

用途:当用户粘贴 Amplitude 图表、仪表盘、实验、笔记本或群组链接并希望理解、刷新或改编分析时使用。

主要能力与用法:先用 get_from_url 解析 URL,返回实体类型、ID 及图表当前定义,无需向用户索要 ID。读取图表定义时用 get_amplitude_charts 并设 include: 'typed',其参数对应图表构建器界面;若 typed 无法降级图表(提示高级功能未建模),改用 include: 'definition' 获取原始形式。仪表盘用 use_amp_dashboards action: 'get'(每批不超过 3 个)获取图表列表。拉取数据用 get_amplitude_charts include: 'data',每次不超过 3 个图表 ID;报告刷新需按所需粒度请求(周环比用日粒度,月度用周粒度)。改编或派生时,编辑 typed 参数后调用 query_amplitude_data,将 chartId 设为已保存图表的 id,使编辑保持与父级关联;用 render_amplitude_chart 渲染,用户通过组件中的 Save chart 按钮保存(没有面向模型的保存工具)。在新环境复制整个仪表盘时,需读取参考仪表盘后逐个重建图表,不能一次调用完成复制。

限制与注意:get_from_url 不运行图表,只返回元数据/定义;数据始终来自 include: 'data' 或 query_amplitude_data。include: 'data' 返回与界面相同的数字,包含 Amplitude 的时区分桶,与外部来源(如 BigQuery)对比时需明确说明时区和部分日期差异。定义读取成本低,数据读取成本高,应先读所有定义再决定哪 1–3 个图表需要数据。仅需链接时用 include: 'link'(默认),验证 ID 并返回 URL,不运行任何内容。