SuperAPI AI 工具集

metronome-renewal-prep

办公与效率

查看项目

更新于 10-16 00:29

技能介绍

用途:为单个客户准备续约简报,包含当前合同条款、近期消费、消耗速率(burn rate)和建议续约价格区间;也可查询续约管道或进行 TCV/毛利/扩展比测算。

主要能力:解析客户名称为 UUID;获取有效合同(起止日期、平台费、费率卡、覆盖、承诺结构);获取近两个完整自然月消费;获取当前及上一周期消费做环比;获取剩余承诺余额;输出续约简报与三档承诺规模建议(保守=当前 TCV−5%,基准=预测年化,激进=预测年化+15%)。

使用方式:所有请求只读,认证头为 Authorization: Bearer $METRONOME_API_TOKEN。生产基址 https://api.metronome.com/v1,沙箱 https://staging.api.metronome.com/v1。关键调用:GET /v1/customers;POST /v2/contracts/list;GET /v1/customers/{customer_id}/costs?starting_on=<month_start>&ending_before=<month_end>;GET /v1/customers/{customer_id}/invoices?type=USAGE&sort=date-desc&limit=3;POST /v1/contracts/customerBalances/list。

限制与注意:金额单位为分,需除以 100,无 formatted_total 字段;消耗速率只用 USAGE 发票,勿用 SCHEDULED;若 costs 返回 $0,改用余额差值 (original_amount - remaining_balance)/months_elapsed;合同结束日期为空需询问用户;当前周期数据不完整,不可用作消耗速率;所有预测须标注为 forecast。PAYGO、常青合同、纯平台费客户需按对应边界情况处理。部分客户可能不在 Metronome 开票,需先确认。