用途
cost-report 用于在 Progress Observability Platform 上报告并解释 LLM 的花费与用量。当用户提出“是什么在推高我的 LLM 成本”“我花了多少钱”之类的问题时,可使用该技能。它把平台中的成本与用量数据转化为一份简短、可直接用于决策的报告。
主要能力
该技能只使用元数据工具,不涉及 trace 内容,因此没有注入面。它依赖两个核心工具:get_cost_breakdown 和 get_usage_summary。所有工具均为只读,技能不会向平台写入任何内容。
报告内容通常包括:
- 标题摘要:所选时间范围内的总花费,以及当前计费周期相对配额的状态。
- 主要驱动因素:承担最多成本的模型或应用及其占比。
- 趋势:逐日变化,指出任何突增及其来自哪个模型或应用。
- 配额:根据周期内已用量线性外推的预计消耗与剩余配额对比(需说明该假设),以及当前速率是否会在周期结束前超出配额。
- 建议(仅在数据支持时给出):例如某条高流量、低风险的调用路径可迁移到更便宜的模型;应将其表述为待验证的假设,而非确定结论。
报告保持精简——几条要点和一个小表格,而不是堆砌数字。
使用方式
技能说明要求先阅读 references/mcp.md 以了解工具契约与限制。如果该文件不存在(例如该技能被单独提取出来),应请用户提供插件的 references/mcp.md,或回退到硬性规则:每个工具都是只读的,且 get_cost_breakdown / get_usage_summary 是该技能唯一需要的工具。
工作流程:
- 确定范围。确认日期范围(get_cost_breakdown 接受 start_date / end_date)以及用户关心的内容——总花费、疑似突增、模型组合或配额余量。未指定时默认最近 7 天。
- 拉取成本。调用 get_cost_breakdown。必要时可多次运行:group_by 设为 "model" 查看模型组合,"application" 查看哪个应用在花费,"day" 查看趋势;首次可用 "all"。
- 拉取用量/配额。调用 get_usage_summary 获取当前计费周期用量与剩余配额。
- 生成报告。按上述结构输出。
适用场景
适用于需要快速了解 LLM 成本构成、排查成本突增、查看模型或应用维度的花费分布、评估配额余量与超支风险的场景。
限制
该技能仅使用只读的元数据工具,不读取 trace 内容,也不向平台写入任何数据。其报告中的配额预测基于周期内已用量的线性外推,属于假设性估算。建议部分仅在数据支持时给出,且应作为待验证的假设。关于具体价格、收费模式、支持平台范围等信息,资料中暂未提供。