Agent Skills
返回列表
用户优惠券详情查询

用户优惠券详情查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,客服、营销或订单 Agent 经常需要确认某一张用户券的真实状态:面额规则、有效期、是否已用、与会员绑定关系等。若把整段「优惠券钱包」能力都塞进一个工具,编排会变重;本 skill 是 coupon_detail 这一原子动作,只负责「根据用户优惠券 ID 查详情」。

技能如何工作

执行器使用 frontmatter 中固定的正式环境 base_url,向以下地址发起 GET 请求(路径参数来自 params.path):

GET https://www.kutetailor.com/api/coupon/coupon-member/getCouponByCouponMember/{couponMemberId}

调用约定与其它酷特平台原子 skill 一致:tool arguments 最外层仅包含 params;登录态通过 params.accessToken 生成 Authorization: Bearer(若已含 Bearer 则不重复拼接);Path 写入 params.path(本接口需 couponMemberId),Query / Body / 额外 Header 分别写入 params.query、params.body、params.headers。返回以接口 RS 响应为准,不补造优惠金额、库存或订单状态;若出现认证、权限、参数或业务错误,应把原始错误码与信息交给上层 Agent。

适用边界

  • 仅覆盖 coupon_detail 单接口;多步业务(发券、核销、列表)需由上层按聚合 skill 或计划文档组合其它原子 skill。
  • 不可用用户输入覆盖正式环境 base_url。
  • 属于查询类接口,仍受当前登录态、租户与用户权限约束。

使用场景

  • 客服工单里用户提供 couponMemberId,需核对这张用户券的面额、有效期与可用状态再回复
  • 订单或售后 Agent 在核销前调用 coupon_detail,确认券详情与接口返回一致后再走下一步
  • 营销自动化流程拿到会员券 ID 列表,逐张拉取详情用于规则校验或文案生成
  • 排查「用户说券不能用」时,用券 ID 查平台侧详情并对照前端展示是否一致

适合人员

  • 处理海外商城客诉、需用券 ID 向酷特平台核实单券状态的客服与售后
  • 编排优惠券钱包多步链路的 Agent 开发者,需要 coupon_detail 原子接口封装
  • 海外运营或增长同学,在活动复盘里要按用户券 ID 核对规则与使用情况
  • 对接 kutetailor.com 优惠券会员接口的后端或集成工程师