基础能力
为所有业务查询与分析技能提供前置上下文与精确命名支撑。本功能簇包含会话与项目上下文、元数据解析两个基础 Skill,分别解决"在哪个会话、哪个项目下操作"和"事件、属性、字段叫什么精确名字"两个前置问题。二者各自独立运作,均为下游技能的必要前置依赖。
| Skill | 定位 | 典型场景 |
|---|---|---|
| 会话与项目上下文 | 初始化会话、确认项目,输出后续所有命令复用的会话标识与项目上下文 | 会话首次调用、任务目标切换、项目切换、多项目消歧 |
| 元数据解析 | 将口语业务名解析为精确的事件名、属性名、表名与枚举值,并管理元数据 | 下游分析或 SQL 执行前的命名发现与消歧、埋点验收、事件与属性创建更新 |
二者共享同一套前置关系:会话与项目上下文是最先执行的技能,产出 project_name 供全部下游技能复用;元数据解析在会话与项目就绪后执行,产出精确的事件名、属性名、字段名与枚举值供分析查询、SQL 生成、分群与标签创建等场景引用。二者均不做业务查询——不执行分析模型、不执行 SQL、不查看板书签、不计算人群规模,只为下游技能提供上下文与命名基石。
会话与项目上下文(sensors-context)
所有业务技能调用 sensors CLI 前的必要前置步骤。会话与用户任务目标绑定:同一目标内复用同一会话,目标切换时新建会话并覆盖旧值。首次调用或目标切换时,将用户意图总结为简短标签新建会话,后续所有命令携带该会话标识。用户已提供精确项目名时直接确认,项目名不确定时列出候选交由用户选择,不猜测。多项目场景禁止自行选择,空结果或无权限时不切换项目重试,建议运行诊断命令排查。仅确认上下文,不执行事件/属性解析、分析查询、SQL 执行或人群管理操作。
元数据解析(sensors-metadata)
事件、属性、表、字段、枚举值的命名解析、schema 校验与元数据管理入口。一方面将口语描述(如"下单""来源渠道")解析为下游技能可直接引用的精确标识,另一方面支持创建事件 schema、创建普通属性及更新事件与属性的显示名、可见性和启用状态。检索时遇多候选项须列出交由用户确认,禁止自行选择;零结果时明确告知"未找到",不回退至其他通道。验证数据上报状态时须使用保留空结果的命令参数,不用默认列表代替。解析完成后记录事件名、属性名、数据类型、枚举值、表名、列名等结构化字段,供 sensors-insight、sensors-sql-query、sensors-cohort、sensors-tag 等下游技能直接引用,无需重复解析。