SuperAPI AI 工具集

derive-metric

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:在指标缺失时解析度量缺口,不保存新定义。按顺序选择首个足够方案,需先确认业务派生度量的情形/事件实体、结果定义与来源、单位、时间基准和聚合方式。区分增量交易与累计快照:不得假定求和、最新值或最大值;非单调快照需权威排序及退款/修正语义。定义缺失即结论不确定,应先询问再计算。不得从示例名称或业务描述推断公式语法。

能力与用法:优先原生输出,使用现有指标及正确范围/聚合。跨天情形可在 F 的 caseMetricConditionFilters 追加 {metric:"CaseDuration",comparisonOperator:"GreaterThan",values:["1.00:00:00"],isInclusive:true},再调用 get_cases_with_metrics_v2 {S,filterOptions:Fplus,itemsPerPage:5,itemsToSkip:0}。普通时长/等待/计数无需公式,应使用原生分组统计。 启用的已保存指标:复用新近 details 中的 CustomMetrics ID/名称/类型/dataType,匹配 Case/Event/Edge 范围与标量类型。布尔 Case 指标 C 可追加 {metric:"CustomMetric",customMetricId:C,comparisonOperator:"EqualTo",values:[true],isInclusive:true},再用 get_process_overall_metrics_v2 {S,filterOptions:Fplus} 取计数。ID 过滤无需公式校验;保存名输出表达式如 EscalatedCase() 仍需走校验/列路径。 本地标量:复用完整、定义兼容、同范围且分母非零的总计,标注为派生而非已保存;不得平均平均值或把重叠组/前 N 样本当作总体总计。 临时公式仅在必要时:加载公式执行能力,复用当前 details 的 PV/PMV,失效则刷新;取定向参考页后用 validate_custom_metric_formula {processVersionId:PV,processExtendedMetadataVersionId:PMV,formula:Fexpr} 校验,候选及修复共允许三次尝试,仅依据结构化错误/定义修复,前置不可用即停。要求 isValid:true、兼容 dataType 和精确目标上下文。校验本身不执行也不保存。 执行最小匹配过滤/查询或默认第五页列查询,如 get_cases_with_metrics_v2 {S,filterOptions:F,itemsPerPage:5,itemsToSkip:0,formulaMetricInput:{name:N,formula:Fexpr}},N 不得与返回内置名冲突,不得虚构 computedColumns 或指标。必要时继续翻页或做独立证据查询;复用已完成结果,回答完毕或无新证据即停。缺校验器禁止未校验执行;列与公式过滤能力独立,遇显式门禁拒绝即停。 限制:没有创建/保存指标工具;前置无法内联时需说明在 MCP 外创建/启用,用户操作后刷新元数据并重新校验。报告定义/公式、单位/上下文、校验状态、至多五行摘要及临时/未保存状态,用调查方法保留定义来源与范围证据。