Agent Skills
返回列表
酷特海外下单页可用优惠券列表

酷特海外下单页可用优惠券列表

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 鉴权约定的平台自动化开发者