SuperAPI AI 工具集

usage-based-billing

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:该技能面向按用量计费场景,提供对客户权益的运行时检查、计量功能的安全用量上报,以及许可证密钥的生命周期管理。

依赖与安装:需要 kelviq 的 MCP 工具(@kelviq/mcp-server 及 KELVIQ_SERVER_API_KEY)。.mcp.json 配置片段及使用 KELVIQ_ENV=sandbox 的沙箱测试说明见 kelviq 技能的 Setup 部分。

主要能力:

  1. 运行时门控。使用 kelviq:entitlements_get,传入 customerId,可选用 featureId 限定单个功能。该调用由边缘节点提供而非主 API,适合廉价的高频运行时访问检查。返回项包含 featureType、hasAccess、usageLimit、currentUsage、resetAt(适用时)。放行动作前应检查 hasAccess,计量功能还需确认 currentUsage 未超过 usageLimit,不应根据客户套餐名称推断访问权。若某客户访问异常,应走 kelviq hub 技能的 diagnose-customer 流程或 diagnose_customer 提示,对比权益与套餐实际授予内容。
  2. 安全上报用量。kelviq:usage_report 接受 SET 或 DELTA 行为。SET 直接替换存储值,重试安全;DELTA 按给定数量递增,盲目重试(如网络超时结果不明后)会重复计数,重试前应先通过 entitlements_get 的 currentUsage 确认首次调用是否已生效;纠正错误计数时优先用 SET 设绝对值,而非补偿性 DELTA。
  3. 许可证密钥。生命周期为 kelviq:license_activate → kelviq:license_validate → kelviq:license_deactivate。activate 将密钥绑定到一个实例(设备或安装)并返回 instanceId,须保存,后续 deactivate 和按实例的 validate 都需要它,丢失则无法干净释放激活槽。validate 检查密钥(可限定实例),返回 { valid, code, detail } 及底层许可证对象。deactivate 释放激活槽以供复用。

限制与建议:回答字段级问题前,先通过 kelviq:docs_read 阅读相关文档,包括 product-catalog/usage-based-billing(计量概念)、product-catalog/entitlements(权益字段)和 product-catalog/license-keys(密钥管理),不要凭记忆枚举响应结构。