简介
本技能是会话与项目上下文的统一入口,所有业务查询类技能在调用 sensors CLI 前,都必须先通过本技能确认project_name。会话与用户任务目标绑定:同一目标内复用同一会话,目标切换时新建会话并覆盖旧值。
本技能仅负责上下文确认,不执行事件/属性解析、分析查询、SQL 执行或人群管理操作。
使用场景
本技能适用于以下任务:
- 当前对话首次需要调用 sensors CLI 时初始化会话;
- 用户任务目标切换(如从"查日活趋势"变为"建分群"),需要新建会话;
- 用户明确要求切换项目或配置上下文;
- 下游技能缺少
project_name; - 多项目场景下需要列出候选项目供用户确认。
执行流程遵循以下路径:首先判定当前属于"同一目标"还是"目标切换"。同一目标(追问、下钻、细化、调整时间范围等)直接复用现有会话,跳过初始化;目标切换或首次调用时,将用户意图总结为一个简短标签新建会话,后续所有命令携带新的会话标识。会话建立后确认项目上下文:用户已提供精确项目名时直接确认,项目名不确定时列出候选交由用户选择,不猜测。
使用案例
| 用户输入 | 系统执行 |
|---|---|
| "我能访问哪些项目?" | 列出可访问项目清单 → 等待用户确认目标项目,不自行选择。 |
常见问题
Q:什么时候需要新建会话?
会话首次调用 sensors CLI 时、用户任务目标切换时(领域、分析模型或对象类型发生变化),必须新建会话。同一目标内的追问、下钻、调整时间范围等属于同一会话,直接复用。
Q:同一目标内能重复初始化会话吗?
不能。上下文已包含当前目标的会话标识和精确项目名时,直接复用,禁止重复执行会话初始化或项目查询。
Q:用户已提供项目名还要先列项目清单吗?
不需要。用户已提供精确项目名时,直接确认该项目,不先调用项目列表。
Q:多项目场景下能自行猜测目标项目吗?
不能。必须列出候选项目交由用户确认,禁止猜测。
Q:查询返回空结果或无权限时能换项目重试吗?
不能。空结果或无权限时返回当前上下文问题并建议运行 sensors doctor 排查,不切换项目重试。
Q:运行时需要开启写操作怎么办?
使用非破坏性的安全命令操作:先查看配置上下文名称,再用局部修改命令开启写权限。禁止运行 config init,该命令会清空并覆盖用户全部配置,仅在用户显式确认后方可执行。
Q:本技能会执行业务查询吗?
不会。本技能只确认会话与项目上下文,不做事件/属性解析、分析查询、SQL 执行或人群管理,这些交给对应的下游技能。