Agent Skills
返回列表
酷特海外优惠券券类型查询

酷特海外优惠券券类型查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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`