简介
本技能是概览与书签功能的统一入口,提供读路径与写路径两类能力。读路径支持查找概览、展开书签列表、执行已保存的书签查询并解释结果;写路径支持创建概览、向概览追加书签、在概览之间复制或迁移书签、从概览移除书签。
概览支持十一类书签类型,涵盖事件分析、漏斗分析、留存分析、分布分析、LTV 分析、用户路径分析、间隔分析、归因分析、用户属性分析、Session 分析及自定义 SQL。用户群画像分析与用户列表查询不支持加入概览。
需要说明的是,本技能不支持编辑已有书签,不支持删除概览。所有写操作均须经用户确认后方可执行,且依赖 CLI 写操作开关处于开启状态。追加的书签数据须来源于当前会话内已执行完成的标准分析或自定义 SQL 的查询输入,不支持根据自然语言临时拼装。
使用场景
本技能适用于以下任务:
- 查看当前用户可见的概览列表;
- 按概览名称、书签名称或书签 ID 定位目标概览与书签;
- 展开指定概览的书签列表,批量巡检书签是否可执行;
- 执行概览中已保存的书签查询并解释查询结果;
- 创建新的空概览(须指定名称与公共/私有类型);
- 将当前会话中的分析查询结果追加为书签;
- 在概览之间复制或迁移书签;
- 从概览移除指定书签。
执行流程遵循以下路径:首先判定用户意图属于"读"还是"写"。读路径仅加载查找与执行相关流程,不进入写操作;写路径仅加载创建、追加、移除相关流程,不直接执行书签查询。查找概览与执行查询是两个独立步骤,仅当用户明确要求执行时才返回查询结果。用户已直接提供概览 ID 时,直接复用该 ID,不再重复查找。同一会话内对同一目标概览的写入操作,首次确认后后续复用,不重复定位。
使用案例
| 用户输入 | 系统执行 |
|---|---|
| "我有哪些看板?" | 列出当前用户可见的概览列表,返回名称与概览 ID。 |
| "执行『高价值用户留存』这个书签查询" | 定位书签 → 用户确认 → 执行查询 → 返回结果并解释口径;结果存在截断时按"结果不完整"口径说明,不下绝对结论。 |
| "创建一个概览叫『核心指标监控』" | 先确认名称与类型(公共/私有)→ 创建空概览 → 返回概览 ID;不接收初始书签,后续通过追加方式加入。 |
| "把刚才的漏斗分析加到概览里" | 取当前会话已执行的漏斗分析输入 → 追加为新书签(ID 传 0)→ 用户确认后写入;仅新增,不更新已有书签。 |
| "把 A 概览里的书签复制到 B 概览" | 确认源概览、目标概览与待迁移书签 → 用户确认后执行复制。 |
常见问题
Q:查找概览会直接返回查询结果吗?
不会。查找与执行是两个独立步骤,仅当用户明确要求执行某个书签时才返回查询结果。
Q:追加书签时能更新已有的书签吗?
不能。追加仅支持新增,不支持编辑已有书签的名称、数据或配置。新追加的书签标识统一传 0,由系统分配。
Q:书签数据可以手工拼装吗?
不可以。书签数据须来源于当前会话内已执行完成的标准分析或自定义 SQL 的查询输入。会话中没有可复用的查询输入时,须先重新执行对应分析,再继续追加。
Q:创建概览时可以同时带初始书签吗?
不可以。创建概览仅创建空壳,不接收初始书签。所有书签须在创建后通过追加方式加入。
Q:能编辑已有书签或删除概览吗?
当前均不支持。不支持编辑已有书签内容,也不支持删除整个概览。如用户提出编辑需求,直接说明不支持,不伪装为追加或更新操作。
Q:写操作被拒绝怎么办?
如写操作被 CLI 以配置原因拒绝(如写操作未开启),如实转达报错与开启指引,请用户在命令行开启后重试,不绕过、不编造写入结果。
Q:结果被截断时如何解释?
按"结果不完整"口径说明,不下"Top""唯一""最高"等绝对结论。建议收口查询范围(减少分组维度、缩短日期范围)后重查。