用途:通过 Deepline 的仓库与语义层工具回答客户分析类问题,如营收、管道、漏斗、转化、留存、用量、账户、商机或仓库表。目标不只是执行 SQL,而是从语义层出发保留客户的业务定义,验证查询路径,并说明实际使用的指标定义与过滤条件。若任务是拓客、数据补全、联系人查找、外呼序列或逐行线索研究,应改用 deepline-gtm。
主要能力:提供 snowflake_get_semantic_layer、snowflake_run_semantic_query、snowflake_run_query、snowflake_update_semantic_layer 等工具,支持指标查询、维度分组、命名过滤、自定义维度与过滤表达式,以及原始 SQL 回退。语义查询返回结果行与渲染后的 SQL,后者可作为审计轨迹与回退起点。
使用方式:先安装并认证。npm install -g deepline;deepline auth register --wait auto;deepline auth wait --timeout 120;deepline auth status。随后用 deepline tools execute snowflake_get_semantic_layer --payload '{"includeYaml": true}' 读取语义层,再用 snowflake_run_semantic_query 执行查询。标准流程为:确认工作区、检查语义层、把用户措辞映射到语义对象、先跑最小查询、检查返回 SQL 与行、用业务语言作答。
适用场景:营收与管道按季度拆分、按产品/月份分解营收、商机/账户/通话计数、指标异常排查、指定仓库表查询、语义层上传与编辑。
限制:若缺少 Snowflake 凭据或语义层,应停止并报告阻塞,不要猜测表名或直接写原始 SQL。rowLimit 不是排序,回答“最近 N 个季度”需配合可排序的日期起始维度并自行排序。语义对象必须使用 YAML 中的规范名称,不能自造。结果被截断时需说明 limited。不要用原始 SQL 静默替换语义指标定义。部分数据源存在延迟或日志形态,需去重并与 Snowflake 比对。具体收费、价格与平台支持暂未提供。