用途:通过 Coval 命令行创建新的 Coval 仪表盘,并用指标组件填充,适合用户提出“create a dashboard”“build a dashboard”“visualize my metrics”等需求时使用。
主要能力:验证 CLI 登录状态;创建仪表盘并获取 dashboard ID;列出可用指标(含内置指标);从历史运行中查看指标与运行详情;为每个指标创建图表组件,并根据指标输出类型选择可视化方式:浮点数值可选 statistic、line、bar、histogram;是/否字符串可选 pie、bar;分类字符串可选 pie、bar、top-list;最后校验组件布局,检查 48 列网格约束与行间空隙。
使用方式:先运行 coval whoami 确认认证,未登录则先 coval login。创建仪表盘:coval dashboards create --name "Dashboard Name"。列出指标:coval metrics list 或 coval metrics list --include-builtin;如需历史运行数据:coval runs list --page-size 10、coval runs get <run_id> --format json。创建组件示例:coval dashboards widgets create <dashboard_id> --name "Widget Name" --type chart --width <columns> --height <rows> --config '{"metricId": "<metric_id>", "visualizationType": "line", "monitoring": "Simulations", "aggregation": "avg", "metricOutputType": "float"}'。选择组件尺寸前需查阅 references/grid-layout.md,了解 48 列网格限制与各组件类型的最小尺寸。完成后用 coval dashboards widgets list <dashboard_id> --format json 校验布局,必要时用 coval dashboards widgets update 修复。
限制与注意事项:组件创建后若不可见,可能是 grid_x、grid_y 为 null,需要用 update 显式设置位置;请求尺寸若被服务器按组件类型最小值调整,应依据 grid-layout.md 使用合法尺寸;config JSON 格式错误或缺少 metricId、visualizationType、monitoring、aggregation、metricOutputType 等必填字段会报 “Invalid request body”。上述内容来自该技能资料,具体收费、平台支持范围和完整参考资料暂未提供。