海外运营优惠券钱包冻结金额查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-query-frozen-price。
技能介绍
要解决什么问题
在海外运营里,优惠券往往挂在「会员优惠券」维度上;除了可用面额,还可能有一部分金额处于冻结状态(例如下单占用、风控锁定等)。对账、客服核对或编排后续发券/解冻流程时,你需要知道「这张券当前冻了多少钱」,而不是凭猜测或拼多个接口的间接字段。
本技能是 最小颗粒度 的原子接口 skill,只完成平台动作 query_frozen_price:向正式环境发起一次查询,并把接口返回作为事实来源交给上层 agent。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境地址
GET https://www.kutetailor.com/api/coupon/coupon-member/queryCouponMemberFrozenPrice,执行器不得用用户输入覆盖base_url。 - 参数约定:tool arguments 最外层仅包含嵌套对象
params;Query 参数写入params.query,其中本接口需要couponMemberId。 - 登录态:通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 返回处理:以接口响应为准,不补造优惠金额、订单号或库存类字段;若出现认证、权限、参数或业务错误,应将原始错误码与错误信息向上传递。
需要「查冻结金额 + 解冻 + 用券下单」等多步链路时,应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill;本技能只承担查询冻结金额这一步。
适用边界与注意点
- 这是查询/计算类 GET 接口,仍受当前登录态、租户与用户权限约束。
- 只覆盖单表动作
query_frozen_price;缺少couponMemberId或 token 无效时,应直接暴露接口错误,而不是在 skill 内臆测业务结果。 - 聚合能力归属
platform-coupon-wallet;本 skill 对应原始 action 为query_frozen_price。
使用场景
- 上层 agent 编排用券或解冻链路前,需按 `couponMemberId` 调用正式环境接口,确认该会员券当前冻结金额。
- 财务或运营对账时,针对单张会员优惠券核对冻结占用是否与订单占用、风控锁定一致。
- 客服处理「余额不可用」类工单时,凭券会员 ID 查询冻结金额,向用户说明被占用部分而非可用面额。
- 聚合 skill `platform-coupon-wallet` 执行计划中单独一步 `query_frozen_price`,将 RS 字段交给后续解冻或结算 skill。
适合人员
- 负责 `platform-coupon-wallet` 多步编排的集成工程师,需在链路里插入仅查询冻结金额的原子调用。
- 对接酷特海外运营正式环境 API 的中台开发,需按 `params.query.couponMemberId` 与 Bearer token 规范传参。
- 处理优惠券占用与对账差异的风控或财务同学,通过 agent 拉取单券冻结金额做事实核对。
- 编写原子 skill 组合计划的技术负责人,需明确本技能只做 GET 查询、不替代解冻或发券接口。