酷特海外优惠券券类型查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-coupon-category。
技能介绍
要解决什么问题
在海外运营里,同一张「优惠券钱包」里的券可能对应 NORMAL(常规)或 MTO(按单定制等)等不同业务类型。后续核销、展示规则或风控往往要先确认券类型,再决定走哪条链路。本 skill 只做一件事:用会员券 ID 调平台正式环境,把接口返回的券类型当作事实来源交给上层 agent。
如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,路径为GET /coupon/category/{couponMemberId},不接受用户改域名。 - 参数约定:tool 参数统一放在嵌套
params里;路径变量写入params.path.couponMemberId;需登录时在params.accessToken生成Authorization: Bearer(已含 Bearer 则不重复拼接)。 - 返回处理:以 HTTP 响应为准,不向用户补造库存、金额、订单号或物流状态;认证、权限、参数或业务错误时,把原始错误码与信息原样交给编排层。
适用边界
这是 platform-coupon-wallet 聚合下的原子 action(coupon_category)。若用户要查列表、领券、核销等多步流程,本 skill 只完成「查券类型」这一步,完整业务需由上层 agent 按聚合 skill 或计划文档串联其它原子 skill。
使用场景
- 上层 agent 在领券或核销前先拿到 `couponMemberId`,需调用本接口确认是 NORMAL 还是 MTO 再选后续原子 skill。
- 海外客服工单里用户提供会员券 ID,运营需在正式环境查券类型后再说明能否走标准促销或定制单规则。
- 对接 `platform-coupon-wallet` 聚合流程时,编排层在单步计划中插入 `coupon_category` 以分支不同业务链路。
- 联调或回归时,用固定正式环境地址与 Bearer 登录态验证指定会员券的类型字段是否与预期一致。
适合人员
- 负责酷特海外运营平台接口对接、需在 agent 里按券类型分支链路的集成工程师
- 维护 `platform-coupon-wallet` 聚合 skill 文档与原子 action 编排的后端或平台开发
- 海外运营或客服工具产品里,要把「查 NORMAL/MTO」做成自动化步骤而非人工查后台的运营支持
- 编写海外优惠券相关业务 agent 的提示词工程师,需要明确本 skill 只覆盖单接口 `coupon_category`