酷特海外 3D 产品配置
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-3d-product-config。
技能介绍
要解决什么问题
3D 或简定制下单时,前端或 Agent 往往只有 productId、category、styleId 等商品骨架,还缺面料与辅料树、标准号型、撞色面辅料以及可提交的价格结果。若直接拼下单接口,容易在配置不完整时进入提单,或在单位(厘米/英寸)与默认尺码上猜错参数。
本技能对应酷特海外运营平台从 platform-fabric-craft 拆出的 3D 产品配置能力,服务根地址固定为 https://www.kutetailor.com/api/product,只负责把 3D 配置链路补齐,再交给完整下单技能。
技能如何工作
推荐按接口动作表顺序调用:
- 从商品详情取
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做 3D 价格计算,再将结果交给下单流程。
另提供查询已保存配置的只读接口:show_product_three_fabric、show_product_three_craft,以及按品类与用户取默认尺寸的 select_customer_size_3d。
边界与注意点
- 不新增或删除已保存的 3D 面料/工艺配置。
- 价格计算失败或配置缺失时,不得进入提交订单。
- 不替用户猜测撞色、辅料或尺码;缺参时应先查接口或向用户确认。
使用场景
- 在 C 站 3D 试衣页拿到 productId 后,需按品类拉取可选面料与辅料分页,再让用户逐项选配
- 简定制商品已选 styleId,下单前必须调用标准号接口并在厘米/英寸间转换部位值
- 用户选定撞色部位后,需 POST 撞色接口拿到面辅料组合,禁止在 Agent 里硬编码配色
- 配置参数齐全后要先 `do_3d_price` 拿到可提交价格,再交给完整下单 skill,避免缺参提单
适合人员
- 对接 kutetailor.com 正式环境、要把 ProductThree 接口编排进海外定制前端的集成工程师
- 从 platform-fabric-craft 拆分后,负责维护 3D 配置链路与下单 skill 衔接的后端或平台同学
- 需要代客查已保存 3D 面料/工艺或默认客尺,且不能擅自改库内配置的一线运营或客服工具开发者
- 为简定制/3D 场景写 Agent 工作流、必须在缺价或缺配置时拦截提单的产品或自动化负责人