酷特海外运营待抢券列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-coupon-pool-page。
技能介绍
要解决什么问题
在海外电商或定制业务里,用户往往要先看到「还能抢哪些券」,再决定领取或下单。若 agent 直接猜券种、库存或面额,会和平台真实数据不一致,后续领券、核销都会失败。本技能只做一件事:按登录态调用酷特海外运营平台的 待抢券分页接口,把接口返回的分页结果原样交给上层编排。
技能如何工作
- 固定环境:请求走 frontmatter 中的正式环境
base_url,路径为GET /coupon-member/couponReceivePoolPage,不允许用用户输入覆盖域名。 - 参数约定:工具参数统一放在嵌套
params里;Query 使用CouponMemberListRequest写入params.query;登录态用params.accessToken生成Authorization: Bearer(已带 Bearer 则不重复拼接)。 - 单一 action:
coupon_pool_page对应上述 GET,返回类型为IPage,即待抢券列表分页数据。 - 事实来源:展示与下游逻辑必须以响应体为准,不要补造优惠金额、库存或券状态;若出现认证、权限、参数或业务错误,应把原始错误码与信息回传上层 agent。
适用边界
这是 platform-coupon-wallet 聚合能力里的原子接口 skill。用户若需要「查列表 → 领券 → 查钱包」等多步链路,需要由上层 agent 组合多个原子 skill 或按计划文档编排;本 skill 只完成列表查询这一步,并把关键字段留给后续步骤。
使用场景
- 客服 agent 在用户问「现在还能领哪些券」时,按会员登录态拉取待抢券分页列表再答复
- 海外运营脚本在领券活动页渲染前,先调用 couponReceivePoolPage 同步可展示券种
- 上层编排 skill 在领券动作前读取 IPage 结果,判断目标券是否仍在待抢池中
- 排查「用户看不到某张券」时,用与线上一致的 Query 参数复现待抢券列表响应
适合人员
- 对接酷特 kutetailor 海外商城、需在对话里查待抢券的运营或客服自动化维护者
- 编写 platform-coupon-wallet 多步链路、负责 coupon_pool_page 原子调用的后端或 agent 工程师
- 海外促销运营在配置领券活动前,需要脚本化核对当前待抢券池内容的同事
- 集成酷特会员优惠券能力、要把列表查询与领券接口拆开的第三方集成开发