酷特海外 3D 面料查询

要解决什么问题

在酷特海外（KuteTailor）的 3D 产品配置流程里，款式选定之后往往还要按 产品 ID 拉取当前可选的 3D 面料列表，才能继续换料、预览或下单。若让通用 agent 自己拼 URL、猜 Query 字段名，很容易打到错误环境或漏掉登录态，返回结果也无法和后续「选料 / 保存配置」步骤对齐。

本技能是 最小颗粒度 的原子接口封装：只负责 select_fabric_by_product 这一动——用正式环境固定地址查询面料，把 ProductFabricsVO 等关键字段交给上层编排。

技能如何工作

• 固定端点：使用 frontmatter 中的正式环境 base_url，对应 GET /product/product/product-three/public/selectFabricByProductId，不接受用户输入覆盖域名。
• 参数约定：工具参数统一放在嵌套对象 params 下；本接口为 GET，查询条件写入 params.query（类型为 ProductFabricRequest）。需要登录时通过 params.accessToken 生成 Authorization: Bearer（若已含 Bearer 则不重复拼接）。
• 返回原则：以接口响应为唯一事实来源，不补造库存、价格或订单状态；认证、权限或参数错误时，应把原始错误码与信息向上传递。

适用边界

• 仅完成 3D 面料查询；若用户要完整配置链路（多步接口），应由上层 agent 引用聚合 skill platform-3d-product-config 或按计划文档串联多个原子 skill。
• 仍受当前 租户与用户权限 约束，查询类接口也需要有效登录态（若网关要求）。