酷特海外下单页可用优惠券列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-checkout-order-coupon-list。
技能介绍
要解决什么问题
在海外运营平台的下单流程里,用户往往要先看到当前订单条件下能用的优惠券,再决定选哪一张。若让上层 Agent 直接拼 HTTP 请求,容易踩坑:正式环境 base_url 被误改、登录态 Authorization 拼接重复、Query 与 Path 混放,或把多张券的可用性「脑补」出来。
本技能是最小颗粒度接口封装,只负责一个动作:order_coupon_list——拉取下单页可用优惠券列表。多步业务(选券、试算、提交订单)应由上层按聚合 skill 或计划文档编排其它原子 skill。
如何工作
- 固定环境:执行器使用 frontmatter 中的正式地址
GET …/coupon-member/orderCouponMemberList,不接受用户输入覆盖base_url。 - 参数约定:
tool arguments最外层仅含嵌套params;Path →params.path,Query →params.query(如couponId、orderType、cloth、fabric、orderIds、productId、amount、isSample等),Body →params.body,额外 Header →params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 结果口径:以接口响应为唯一事实来源,不补造优惠金额、库存或订单状态;认证、权限、参数或业务错误时,将原始错误码与信息交给上层 Agent。
适用边界
- 仅覆盖查询类下单页可用券列表,不包含领券、核销或下单提交。
- 仍需遵守当前租户、用户权限与登录态;网关若对 POST/PUT 有特别约定,以网关为准(本接口为 GET)。
- 归属聚合域
platform-coupon-checkout,与文档doc/skill/platform-coupon-checkout/SKILL.md中的完整链路配合使用。
使用场景
- 海外定制下单 Agent 在提交前,按订单类型、面料与金额拉取当前可用的优惠券列表供用户选择
- 客服 Agent 根据客户提供的订单号或商品信息,查询下单页接口返回的可核销券明细
- 编排 platform-coupon-checkout 链路时,由本原子 skill 单独完成 order_coupon_list 并把 RS 交给试算或提交步骤
- 联调正式环境时,用固定 base_url 与 accessToken 验证 cloth、fabric、isSample 等 Query 条件下的券列表是否与页面一致
适合人员
- 负责酷特海外运营平台接口对接、需在 Agent 中封装登录态 GET 的后端或集成工程师
- 维护 platform-coupon-checkout 聚合 skill、要把下单选券步骤拆成原子调用的技能编排维护者
- 海外电商运营或客服主管,希望 Agent 能按真实订单条件查询可用券而非口头规则
- 对接 kutetailor.com 优惠券域、需要统一 params 嵌套与 Bearer 鉴权约定的平台自动化开发者