Kutesmart 购物车订单可用优惠查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-coupon-checkout-cart-coupon-info 到当前 AI 助手。
技能介绍
解决什么问题
当上层 Agent 需要判断购物车订单里哪些优惠可用时,通常要自己拼 HTTP 请求、处理鉴权头、区分查询参数,并把返回值交给后续流程。这个 skill 把这些细节收敛为一个最小颗粒度动作:cart_coupon_info。它不负责完整下单、核销或跨接口编排;在需要组合业务链路时,由聚合 skill 或计划文档调用多个原子 skill。
技能如何工作
- 固定入口:执行器从 frontmatter 的
base_url读取正式环境地址,调用GET https://www.kutetailor.com/api/order/order/orden/myCartListCouponInfo,不接受用户输入覆盖。 - 参数封装:tool arguments 统一使用嵌套
params对象;最外层只放params,不要写成params.xxx这类点号顶层 key。 - 请求拆分:路径变量写入
params.path,查询参数写入params.query,JSON Body 写入params.body,额外 Header 写入params.headers。 - 认证方式:登录态接口使用
params.accessToken生成Authorization: Bearer;如果传入值已含Bearer,不要重复拼接。 - 当前接口:
cart_coupon_info对应GET /order/orden/myCartListCouponInfo,查询参数为逗号分隔的orderIds,用于异步获取购物车订单可用优惠信息。 - 结果透传:返回结果以接口响应为事实来源,只把关键字段交给后续 skill,不补造库存、价格、订单号、优惠金额或物流状态。
适用边界与注意点
- 这是查询或计算类接口,仍必须遵守当前登录态、租户和用户权限;认证失败、权限不足、参数错误或业务错误时,应把原始错误码和错误信息传给上层 Agent。
- 它只完成本接口调用;如果用户需求需要多个接口步骤,需要由上层 Agent 按聚合 skill 或计划文档继续编排。
POST/PUT默认发送 JSON body,但若上层接口网关另有约定,以网关契约为准。- 该 skill 属于聚合 skill
platform-coupon-checkout,原始 action 为cart_coupon_info,来源文档为doc/skill/platform-coupon-checkout/SKILL.md。
使用场景
- 运营人员在配置购物车结算页时,需要知道哪些优惠券可以应用到当前购物车订单,调用此接口获取可用优惠列表。
- 上层 Agent 在处理下单流程时,需要先查询购物车订单可用的优惠信息,再决定最终价格和优惠方案。
- 运营平台需要为购物车中的每个订单计算可使用的优惠券,调用此接口异步获取优惠结果并展示给用户。
- 在搭建优惠聚合流程时,Agent 需要先获取购物车订单可用优惠,再将结果传递给后续的优惠选择或结算步骤。
适合人员
- 电商平台运营人员,需要为购物车结算页配置优惠券展示,了解订单可用的优惠信息以优化购物流程。
- AI Agent 开发者,在构建购物车或下单相关 Agent 时,需要一个可靠的接口来获取购物车订单的可用优惠数据。
- 海外运营平台技术团队,负责维护 Kutesmart 平台优惠相关接口,需要了解 cart_coupon_info 接口的调用规范和参数要求。
- 聚合流程设计者,在编排多个原子 skill 组成完整业务链路时,需要将此接口作为优惠查询环节接入流程。