Agent Skills
返回列表
酷特海外运营·成品券适用查询

酷特海外运营·成品券适用查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台的优惠券钱包里,成品券往往绑定特定商品、类目或活动规则。客服、运营或自动化 Agent 在发券、改价或排查「为什么这张券用不了」时,需要先拿到成品券适用信息——例如适用范围、限制条件等——而不是凭猜测补全业务字段。

本技能是 coupon_finish 这一接口的最小颗粒度封装:只负责按券 ID 发起一次 GET 查询,并把接口原样返回交给上层编排;多步骤业务(登录、列表、核销等)需由聚合 skill 或其它原子 skill 组合完成。

技能如何工作

  • 固定正式环境:请求地址为 GET https://www.kutetailor.com/api/coupon/coupon/couponFinish,以 skill frontmatter 中的 base_url 为准,不接受用户输入覆盖域名或环境。
  • 参数约定:tool 入参最外层仅包含嵌套的 params;Query 参数(本接口为 id)写入 params.query;需登录时在 params.accessToken 中传 token,执行器生成 Authorization: Bearer …(若已含 Bearer 则不重复拼接)。
  • 返回原则:库存、价格、订单号、优惠金额、物流状态等均以接口响应为唯一事实来源;若返回认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,便于 Agent 重试或改计划。

适用边界与注意点

  • 仅覆盖「查询成品券适用信息」单步;用户若描述的是完整发券/对账流程,本 skill 只完成其中本接口调用。
  • 属于查询类接口,仍受当前登录态、租户与用户权限约束;无权限时不会「推断」适用结果。
  • 上层聚合参考:platform-coupon-wallet(见 doc/skill/platform-coupon-wallet/SKILL.md)。

使用场景

  • 客服收到「成品券无法用于某 SKU」工单,需用券 ID 调 couponFinish 核对适用范围再回复
  • 运营在活动上线前,按券 ID 批量查询成品券适用信息,确认与海外站点商品配置一致
  • Agent 编排优惠券链路时,在拿到券标识后单独调用本接口,把适用信息交给后续核销或定价 skill
  • 排查发券失败时,先 GET 查询该成品券适用条件,对照接口返回而非本地假设

适合人员

  • 负责酷特海外站点大促配置、需核对成品券与商品适用关系的运营
  • 搭建 platform-coupon-wallet 原子 skill 链路、需嵌入 coupon_finish 步骤的 Agent 集成工程师
  • 处理 kutetailor 优惠券争议、需用正式环境接口查实适用信息的客服或二线支持
  • 在自动化脚本里按券 ID 拉取成品券适用详情、供规则引擎或报表使用的后端开发