海外运营平台 3D 撞色面辅料选择
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-3d-product-config-select-3d-contrast。
技能介绍
要解决什么问题
在酷特海外运营平台的 3D 产品配置 流程里,用户需要为款式选定 撞色面辅料(面料、辅料及其 3D 展示相关选项)。这一步对应后端公开接口 select3DContrast:根据请求体 ProductFabricRequest 做查询或计算,返回可选结果供前端或上层 agent 继续配置。
本技能是 最小颗粒度 的原子 skill,只负责发起这一次 POST,不代替整条「登录 → 选款 → 保存配置」链路;多步业务应由上层 agent 按聚合 skill platform-3d-product-config 或计划文档编排多个原子接口。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境地址
https://www.kutetailor.com/api/product/product/product-three/public/select3DContrast,执行器不得用用户输入覆盖base_url。 - 统一入参:tool 参数最外层仅包含嵌套对象
params;Path 进params.path,Query 进params.query,JSON Body 进params.body,额外 Header 进params.headers。 - 登录态:需权限时通过
params.accessToken生成Authorization: Bearer <token>;若已含Bearer前缀则不再重复拼接。 - 请求形态:
select_3d_contrast→ POST,Body 为 application/json 格式的ProductFabricRequest,按接口定义提交,勿擅自改成非约定结构。 - 结果处理:以接口原始响应为准;认证、权限、参数或业务错误时,将错误码与错误信息原样交给上层 agent,不要补造库存、价格、订单号等字段。
适用边界与注意点
- 仅覆盖 3D 撞色面辅料选择 这一动作;若用户需求包含其它产品三维接口,需组合其它原子 skill。
- 仍为 查询/计算类 接口,受当前租户、用户权限与登录态约束;无 token 或权限不足时 expect 接口层错误而非本地猜测结果。
使用场景
- 海外运营后台为某款西装配置 3D 预览时,需按款式请求撞色面料与辅料候选列表
- 上层 agent 编排 platform-3d-product-config 链路,执行到撞色面辅料步骤时调用 select3DContrast
- 客服或商品同事在对话中确认客户选定款式的撞色辅料是否可选,需直连正式环境查询接口
- 自研配置助手已拿到 accessToken,要把 ProductFabricRequest 提交给三维公开接口并解析 RS 返回
适合人员
- 对接 kutetailor 海外运营 API、用 agent 拼装三维产品配置多步链路的后端集成工程师
- 负责款式上架与 3D 展示的商品运营,希望通过对话触发撞色面辅料查询而非手工点后台
- 维护 platform-3d-product-config 聚合 skill、需要嵌入 select_3d_contrast 原子动作的技能编排维护者
- 为定制业务做智能导购的产品/实施同学,需在选款后自动拉取撞色面辅料选项供用户确认