酷特海外 3D 产品厘米英寸部位转换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config-switch-position-3d。
技能介绍
要解决什么问题
海外定制与 3D 产品配置里,同一套部位尺寸往往要在 厘米(cm) 与 英寸(inch) 之间切换展示或下单。若由前端或 Agent 自行换算,容易出现精度、字段含义不一致,或与平台侧配置规则脱节的问题。本技能只做一件事:按酷特海外运营平台约定,调用正式环境的 switchPosition3D 查询接口,把部位相关参数交给服务端完成转换,并以接口返回的 List 作为唯一结果来源。
技能如何工作
这是最小颗粒度的原子 skill,对应 action switch_position_3d:
- 请求方式:
GET,路径为/product/product/product-three/public/switchPosition3D(完整 base 固定在 skill frontmatter,调用时不得被用户输入覆盖)。 - 参数组织:tool 参数统一放在嵌套对象
params下;查询条件写入params.query,路径变量写入params.path,需要时可用params.accessToken生成Authorization: Bearer(已含Bearer则不重复拼接)。 - 返回处理:以 HTTP 响应体为准向上层返回;不补造库存、价格、订单号等业务字段。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 Agent 继续编排。
需要「登录 → 拉配置 → 换算 → 保存」等多步链路时,应由上层按聚合 skill(如 platform-3d-product-config)或计划文档组合多个原子 skill;本技能只负责换算这一步。
适用边界与注意点
- 仅覆盖 厘米/英寸部位值转换 这一接口动作,不替代完整的 3D 产品配置 CRUD 或其它运营接口。
- 仍受当前 登录态、租户与用户权限 约束;无权限时按接口原样报错即可。
- 属于查询/计算类 GET:不要把本接口当成写库或下单接口来用。
使用场景
- 海外定制 Agent 在提交 3D 部位参数前,需把顾客填写的英寸量体值转成平台要求的厘米字段
- 多步编排里仅负责换算:上层已拿到部位列表,调用 `switch_position_3d` 完成公制/英制切换后再交给保存类 skill
- 运营后台或客服辅助工具在英制站点与公制配置数据不一致时,按查询参数请求平台统一换算结果
- 对接 `platform-3d-product-config` 聚合流程时,单独触发厘米与英寸部位值转换而不改动其它配置接口
适合人员
- 负责对接 Kutetailor 正式环境 `switchPosition3D` 接口的后端工程师,需在 Agent 中固定 base_url 与 `params` 传参规范
- 编排海外 3D 定制链路的 Agent 开发者,要把 `switch_position_3d` 作为单步原子能力嵌入更大计划
- 酷特海外运营平台实施或产品同学,需核对部位展示单位与平台配置字段是否经同一换算接口
- 维护 `platform-3d-product-config` 聚合 skill 的维护者,需要明确原子 action 边界与错误透传方式