酷特海外运营·成品券适用查询
将以下提示词粘贴到你的 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 拉取成品券适用详情、供规则引擎或报表使用的后端开发