用途:为 Metronome 计费指标设计 group_keys,并配置产品上的 pricing_group_key / presentation_group_key,涉及定价、发票展示、支出拆分、席位信用与用量告警。group_keys 在指标创建后不可修改,必须在首次调用 API 前确定。
主要能力与规则:group_keys 中每个属性以及 aggregation_key 都需要在 property_filters 中有 exists: true 的对应项,否则创建调用会返回具名错误。基数成本是各维度基数的乘积而非求和,组合键扫描成本会随维度乘积快速上升;预计每客户约 1000 个唯一值的维度建议上线前联系 Metronome 支持。同一请求中共同出现的维度必须放在同一个组合键中,事后无法合并;用量告警是例外,告警评估只查询单个维度,应保持独立键。
使用方式:先识别事件维度及其规模(固定枚举还是随用量增长),再确定影响价格的定价维度,然后判断每个非定价维度是否与定价维度共同出现,最后决定独立键或组合键。创建前需展示确认表并获得明确确认,再调用 POST /v1/billable-metrics/create,随后在 POST /v1/contract-pricing/products/create 中设置 pricing_group_key 与 presentation_group_key。
限制:发票展示的组合键不可省略,否则发票计算会失败;不要把所有维度放在一个组合键上;不要对随用量增长的维度设置用量告警;不要为节省键位合并无关特征维度。本技能仅覆盖 group key 设计,完整目录流程需返回 metronome-setup-catalog Step 3。