Agent Skills
返回列表
酷特海外 3D 产品厘米英寸部位转换

酷特海外 3D 产品厘米英寸部位转换

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 边界与错误透传方式