什么是Aloudata CAN SKILLS – metric-query
Aloudata CAN SKILLS – metric-query 是一个专为构建指标平台（语义层）而设计的智能数据查询工具，核心功能是通过自然语言理解自动生成标准化的指标查询 API 请求体。该工具能够解析用户的业务需求，自动检索系统中的可用指标和维度，并根据用户意图构造符合规范的 JSON 请求格式，最终通过调用 `/semantic/api/v1.1/metrics/query` 接口获取结构化数据结果。它特别适用于需要快速构建复杂指标计算、时间对比、占比排名等分析场景的数据分析师和业务人员，极大降低了手动编写查询语句的技术门槛。整个流程分为两步：首先通过 Gateway API 动态获取指标元数据和维度信息，然后基于语义理解生成精准的数据查询请求。
核心功能特点
- 支持自然语言解析，自动识别指标、维度、时间范围和计算方式
- 内置九条核心规则校验机制，确保查询逻辑正确性（如相对时间必须使用 NOW()、禁止链式叠加快速计算等）
- 提供完整的指标与维度检索能力，支持批量搜索和多指标维度交集计算
- 支持同环比、占比、排名、时间限定等多种快速计算语法
- 允许定义临时指标（metricDefinitions），实现跨时段对比、复合表达式和高级筛选
适用场景
该工具主要面向需要频繁进行数据分析的业务团队和技术人员，典型应用场景包括实时监控关键业务指标变化趋势、执行多维度交叉分析以及生成定制化数据报表。例如，当用户询问“上月各渠道销售额及月环比增长率”时，系统会自动提取‘销售额’作为核心指标，识别‘渠道’为分组维度，设置时间为上月，并生成包含同比计算的查询请求；又如，在分析‘近30天日均订单数’时，工具会结合 period 限定与 preAggs 多层聚合功能，准确返回平均值而非逐日明细。此外，对于涉及复杂逻辑的需求——如‘Wholesale 渠道内品牌销售额占比’或‘TOP10 高增长商品’——可通过 resultFilters 控制展示范围而不影响整体分母计算，保证统计口径一致性。无论是简单的单指标查询还是多步骤嵌套计算，该工具都能依据上下文判断并输出合规的 API 请求体，显著提升数据获取效率与准确性。