菜单

会话与项目上下文(sensors-context)

简介

本技能是会话与项目上下文的统一入口,所有业务查询类技能在调用 sensors CLI 前,都必须先通过本技能确认project_name。会话与用户任务目标绑定:同一目标内复用同一会话,目标切换时新建会话并覆盖旧值。

本技能仅负责上下文确认,不执行事件/属性解析、分析查询、SQL 执行或人群管理操作。

使用场景

本技能适用于以下任务:

  • 当前对话首次需要调用 sensors CLI 时初始化会话;
  • 用户任务目标切换(如从"查日活趋势"变为"建分群"),需要新建会话;
  • 用户明确要求切换项目或配置上下文;
  • 下游技能缺少 project_name ;
  • 多项目场景下需要列出候选项目供用户确认。

执行流程遵循以下路径:首先判定当前属于"同一目标"还是"目标切换"。同一目标(追问、下钻、细化、调整时间范围等)直接复用现有会话,跳过初始化;目标切换或首次调用时,将用户意图总结为一个简短标签新建会话,后续所有命令携带新的会话标识。会话建立后确认项目上下文:用户已提供精确项目名时直接确认,项目名不确定时列出候选交由用户选择,不猜测。

使用案例

用户输入 系统执行
"我能访问哪些项目?" 列出可访问项目清单 → 等待用户确认目标项目,不自行选择。

常见问题

Q:什么时候需要新建会话?
会话首次调用 sensors CLI 时、用户任务目标切换时(领域、分析模型或对象类型发生变化),必须新建会话。同一目标内的追问、下钻、调整时间范围等属于同一会话,直接复用。

Q:同一目标内能重复初始化会话吗?
不能。上下文已包含当前目标的会话标识和精确项目名时,直接复用,禁止重复执行会话初始化或项目查询。

Q:用户已提供项目名还要先列项目清单吗?
不需要。用户已提供精确项目名时,直接确认该项目,不先调用项目列表。

Q:多项目场景下能自行猜测目标项目吗?
不能。必须列出候选项目交由用户确认,禁止猜测。

Q:查询返回空结果或无权限时能换项目重试吗?
不能。空结果或无权限时返回当前上下文问题并建议运行 sensors doctor 排查,不切换项目重试。

Q:运行时需要开启写操作怎么办?
使用非破坏性的安全命令操作:先查看配置上下文名称,再用局部修改命令开启写权限。禁止运行 config init,该命令会清空并覆盖用户全部配置,仅在用户显式确认后方可执行。

Q:本技能会执行业务查询吗?
不会。本技能只确认会话与项目上下文,不做事件/属性解析、分析查询、SQL 执行或人群管理,这些交给对应的下游技能。

上一个
基础能力
下一个
元数据解析(sensors-metadata)
最近修改: 2026-08-12