Agent Skills
返回列表
购物车订单优惠券校验与优惠计算

购物车订单优惠券校验与优惠计算

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-coupon-checkout-cart-coupon-check。

技能介绍

要解决什么问题

在酷特海外运营(KuteTailor)结账链路里,用户选中优惠券后,需要先确认这些券能否用于当前购物车订单,并拿到可计算的优惠结果,再进入提交或支付。若把整段优惠与提交流程塞进一个巨型工具,Agent 难以按步骤重试、组合和排错。

本技能是最小颗粒度的原子接口技能,只负责 cart_coupon_check:对指定订单发起购物车订单优惠券基础校验与优惠计算。

技能如何工作

  • 固定正式环境:请求走 frontmatter 中的 base_url(GET …/coupon-member/cartOrderCouponCheck),调用方不得用用户输入覆盖域名。
  • 统一参数形态:tool 参数最外层仅包含嵌套对象 params;Query 写入 params.query(如 orderIds),登录态用 params.accessToken 生成 Authorization: Bearer(已带 Bearer 前缀则不重复拼接)。
  • 事实来源:返回以接口响应为准,不补造优惠金额、订单号或库存;认证、权限、参数或业务错误时,把原始错误码与信息交给上层 Agent 编排。

适用边界与注意点

  • 仅覆盖单接口动作;若需求包含领券、改购物车、下单等多步,应由上层按聚合 skill platform-coupon-checkout 或计划文档串联多个原子 skill。
  • 本接口为查询/计算类,仍受当前登录态、租户与用户权限约束;orderIds 等 Query 需与平台契约一致。

使用场景

  • 结账前 Agent 已拿到购物车订单 ID 列表,需调用 cartOrderCouponCheck 校验所选券是否可用并返回优惠计算结果
  • 海外运营客服脚本在改单场景中,需对指定 orderIds 重新跑一遍优惠券基础校验,避免口头承诺与系统不一致
  • 编排 platform-coupon-checkout 链路时,在展示应付金额前单独插入本接口,把 RS 中的优惠字段交给后续提交 skill
  • 联调 KuteTailor 正式环境时,用固定 base_url 与 Bearer 登录态验证 orderIds 参数与错误码回传是否符合网关契约

适合人员

  • 负责酷特海外电商结账 Agent 编排的后端工程师,需要把优惠计算拆成可单独重试的原子步骤
  • 维护 platform-coupon-checkout 聚合 skill 的平台集成同学,要在文档里对齐 cart_coupon_check 的入参与 RS 字段
  • 海外运营侧做优惠规则验收的测试工程师,需用真实 orderIds 对照接口返回的优惠金额与错误信息
  • 为客服或运营 Copilot 写工具链的开发者,只需完成「校验+算价」一步而不接管整单提交