SuperAPI AI 工具集

metronome-commit-health

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:分析客户预付费承诺(commit)的健康状况,回答客户相对承诺的消耗节奏、是否存在超支风险(消耗过快)或 breakage 风险(消耗不足、余额到期未用)。适用于单一客户体检、燃烧顺序排查、breakage 风险识别和指定客户列表的批量扫描。

主要能力:

  • 单一客户承诺健康:解析客户名称为 UUID,拉取有效 commit 与 credit 余额,按最近两个完整自然月取成本数据算燃烧速率,并结合合同结束日期做耗尽日期预测与风险分类。
  • 燃烧顺序:按 priority 升序返回消耗顺序,数字越小越先消耗,并用 is_active 判断当前正在消耗的承诺。
  • breakage 风险:合同期已过 >80% 而 percentage_consumed <20% 时标记风险。
  • 多客户扫描:无全量客户 commit 接口,需用户提供有界客户名单或 ID 后逐个排查,结果按超支、breakage、健康排序输出。

必要用法:所有请求带 Authorization: Bearer $METRONOME_API_TOKEN。Base URL 为 https://api.metronome.com/v1(生产)或 https://staging.api.metronome.com/v1(沙箱)。拉余额必须传 include_balance: true,否则 percentage_consumed 和剩余余额为 null;该接口每页上限 25 条,需用 next_page 分页。燃烧速率用最近两个完整自然月平均,不用 USAGE 发票总额;金额为美分,展示前除以 100。

限制与注意:所有调用只读。合同结束日期常缺失,若为空需向用户确认后再做预测。合同无终止日期(常青合同)无法算时间进度,跳过 breakage 判断。无 PREPAID 的纯 PAYGO 客户不做燃烧与耗尽预测。CREDIT_EXPIRATION 是余额核销而非扣费,不要当作异常支出。预测必须标注为 forecast,不能当作事实。客户不一定通过 Metronome 开票,调用发票接口前需确认。API 返回 $0 时先检查是否为 credit 优先消耗。多客户全量扫描不可行。