youdata-metrics-nl-choose
SKILL.md
有数指标查找和选择技能
使用场景
- 用户提出数据分析问题,需要先找到对应的指标
- 用户想浏览或检索有哪些可用指标
依赖环境
- Node.js 20+
- 需要网络连接访问知数平台API
- 需要安装 skill
youdata-env-config并完成配置
使用方法
- 提供用户问题 (question)
调用示例
- step1:使用 skill
youdata-env-config获取 env(json字符串格式) - step2:获取当前 SKILL.md 的绝对目录地址 skillFolder
- step3:调用脚本
node ${skillFolder}/scripts/index.js <question> <env>
参数说明
question: 用户的自然语言问题,用于语义匹配指标
返回结果
返回Markdown形式返回结果,主要包含以下内容:
总共有以下这些指标:
指标ID=68;
指标名称="各地区销售额";
指标的数据类型(colType)=int;
指标对应的统计日期的元信息以表格的形式展示如下:
| colId | colName | colType | member example | colDescription |
|--|-|-|-|-|
| q6fM9_180183 | 订单日期 | Date | | |
指标对应的分析维度(analysis dimensions)的元信息以表格的形式展示如下:
| colId | colName | colType | member example | colDescription |
|--|-|-|-|-|
| q6fM9_180191 | 国家 | string | | |
| q6fM9_180189 | 城市 | Date | | |
| q6fM9_180186 | 客户ID | string | | |
| q6fM9_180187 | 客户名称 | string | | |
| q6fM9_180190 | 省/自治区 | string | | |
| q6fM9_180194 | 类别 | string | | |
| q6fM9_180182 | 订单ID | Date | | |",
错误处理
- 缺少参数时会提示正确用法
- 配置不完整时会提示配置信息
- 网络错误会显示具体错误信息
- 脚本查询失败时显示错误信息并立刻终止问答