酷特海外运营购物车可用优惠查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-checkout-cart-coupon-info。
技能介绍
要解决什么问题
在海外运营平台的下单与优惠链路里,结算前往往需要知道当前购物车/订单能叠哪些券、优惠规则是否仍有效。这类信息通常由后端异步计算,前端或上层 agent 不能只凭本地缓存猜优惠金额。
本技能对应平台原子动作 cart_coupon_info:在已登录、具备权限的前提下,按一批 orderIds 拉取购物车订单可用优惠信息,把接口原始响应交给后续步骤(选券、改单、提交等)。
技能如何工作
- 固定环境:执行时使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api),路径为GET /order/orden/myCartListCouponInfo,不接受用户输入覆盖域名。 - 参数约定:tool 参数统一放在嵌套对象
params里;Query 写入params.query,其中orderIds为逗号分隔的订单 ID 列表。 - 登录态:通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 返回事实:以接口响应为准,不补造优惠金额、库存、订单号或物流状态;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递。
适用边界与注意点
这是最小颗粒度接口 skill,只完成单次 cart_coupon_info 调用。若业务需要「查券 → 试算 → 提交订单」等多步流程,应由上层 agent 按聚合 skill platform-coupon-checkout 或计划文档编排多个原子 skill。
接口仍受当前租户与用户权限约束;查询类接口也需要有效登录态,缺 token 或权限不足时应直接暴露平台返回,而不是在本地臆测可用优惠。
使用场景
- 结算前 agent 已拿到一批购物车订单 ID,需调用正式环境接口拉取各单可用优惠券列表供用户勾选。
- 编排 platform-coupon-checkout 链路时,在试算或提交前单独执行 cart_coupon_info,用返回字段驱动下一步选券逻辑。
- 客服或运营助手根据用户提供的 orderIds,核对当前账号下这些订单还能用哪些平台优惠,避免口头承诺与后台不一致。
- 购物车改数量或拆单后 orderIds 变更,需重新异步查询 myCartListCouponInfo 再更新展示给业务侧。
适合人员
- 对接 kutetailor 订单与优惠接口、要在 agent 里固定走 Bearer 登录态的海外平台后端集成工程师
- 维护酷特海外运营下单链路、需把查可用券与提交拆成多个原子 skill 编排的自动化方案负责人
- 为运营或客服搭建对话式查单工具、需按逗号分隔 orderIds 查询购物车优惠事实数据的内部工具开发
- 编写 platform-coupon-checkout 聚合文档、需要明确 cart_coupon_info 边界与错误上抛方式的技能编排作者