Agent Skills
返回列表
海外优惠券钱包·我的券与待抢券

海外优惠券钱包·我的券与待抢券

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-coupon-all-page。

技能介绍

要解决什么问题

海外运营侧的优惠券钱包通常把「已领取的我的券」和「仍可抢的待抢券」拆在不同入口或接口里。若 agent 要在一次对话里帮用户盘点可用优惠、对比待领活动,就需要一个合并分页列表,而不是分别调两个列表再手工拼数据。

本 skill 对应酷特海外平台(正式环境 kutetailor.com)上的原子动作 coupon_all_page:只负责 GET /coupon-member/couponAllPage,返回 IPage 结构的分页结果。

技能如何工作

  • 固定使用 frontmatter 中的正式环境 base_url,不接受用户输入覆盖域名。
  • 调用参数统一放在嵌套对象 params 里:Query 条件写入 params.query(类型为 CouponMemberListRequest),登录态通过 params.accessToken 生成 Authorization: Bearer(若已含 Bearer 则不重复拼接)。
  • 执行器按 GET 语义把查询参数拼到 URL;响应以接口返回为准,不补造库存、面额、订单号等业务字段。
  • 若返回认证、权限、参数或业务错误,应把原始错误码与信息交给上层 agent 处理。

适用边界

这是最小颗粒度接口 skill,不包含领券、核销、详情页跳转等后续步骤。完整「优惠券钱包」链路需由上层 agent 参考聚合 skill platform-coupon-wallet 编排多个原子 skill。

使用场景

  • 客服对话中需一次性列出会员已持有券与仍可领取的待抢券,避免分别查两个接口再手工合并
  • 结账前由 agent 拉取 couponAllPage 分页结果,向用户说明当前可用优惠与待领活动
  • 编排 platform-coupon-wallet 链路时,用本 skill 作为「券列表」原子步骤,再把关键字段交给领券或详情 skill
  • 排查「看不到某张券」类工单时,按 CouponMemberListRequest 条件查询合并列表并对照接口原始返回

适合人员

  • 对接酷特 kutetailor 会员体系的集成工程师,需要在 agent 中封装 couponAllPage 查询
  • 海外电商客服或会员运营,在对话里帮用户核对「我的券」与「待抢券」合并视图
  • 负责 platform-coupon-wallet 聚合 skill 编排的产品或 agent 设计,需明确列表原子接口边界
  • 处理登录态、分页与权限错误的运维或二线支持,需把接口原始错误码透传给上层