酷特海外平台 3D 产品配置
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config。
技能介绍
要解决什么问题
海外 C 站上的 3D/简定制 下单链路,不能只有商品 ID 就提交:还需要面料、辅料、标准号型、部位单位(厘米/英寸)以及撞色面辅料组合,最后才能算出价格并交给完整下单 skill。本技能从原 platform-fabric-craft 拆出,只负责 3D 下单配置 这一段,对接正式环境根地址 https://www.kutetailor.com/api/product。
技能如何工作
通过一组固定的 action → HTTP 接口 映射完成配置补齐,典型顺序如下:
- 从商品详情取得
productId/category/styleId,从 C 站上下文取得source/originSign。 - 调用
select_fabric_by_product、select_aided_by_product拉取 3D 面料与辅料。 - 调用
select_3d_standard_size获取标准号信息;若用户切换单位,用switch_position_3d做部位值转换。 - 用户选撞色时 POST
select_3d_contrast。 - 参数齐全后 POST
do_3d_price得到价格,再交给完整下单 skill。
辅助查询还包括:show_product_three_fabric、show_product_three_craft(已保存的 3D 面料/工艺),以及 select_customer_size_3d(按品类与用户默认尺寸)。
边界与注意点
- 只读配置侧:不新增、不删除已保存的 3D 面料或工艺。
- 价格与完整性:
do_3d_price失败或关键配置缺失时,不应进入提交订单。 - 不替用户猜选项:撞色、辅料、尺码需由用户或上游上下文明确,避免静默填默认值导致错单。
使用场景
- 海外 C 站商品页已有 productId,需在对话或 Agent 里依次拉面料、辅料与标准号再报价
- 简定制/3D 流程中用户切换厘米与英寸,需调用部位转换后再查标准尺码
- 用户选定撞色面辅料组合时,按品类与 fabric 请求 POST 撞色接口并校验返回
- 价格计算完成后,把 C3DPriceRequest 结果交给完整下单 skill,避免缺参提交
适合人员
- 对接 kutetailor `/product/product-three` 系列接口的海外站后端或集成工程师
- 维护酷特海外 3D/简定制下单链路、需与 platform-fabric-craft 拆分后技能编排的运营集成同学
- 编写多技能 Agent、在下单前必须补齐面料辅料与计价的对话流程设计者
- 负责 C 站 source/originSign 与商品 styleId 上下文,排查缺参导致无法报价的支持人员