酷特海外平台 3D 面料查询

要解决什么问题

在海外运营平台的 3D 产品配置 流程里，选款、换料往往依赖「当前产品能配哪些面料」这一前置数据。若由 Agent 自行拼 URL 或猜测查询字段，容易踩到环境地址、参数命名和登录态头不一致的问题，返回结果也无法与平台侧 ProductFabricsVO 对齐。

本技能是 最小颗粒度 的原子接口封装，只负责一次动作：select_fabric_by_product——按产品维度查询可用面料，供上层在配置链路中继续选料、预览或下单前校验。

技能如何工作

• 固定正式环境：执行器使用 frontmatter 中的 base_url（https://www.kutetailor.com/api/product/...），不接受用户输入覆盖。
• 请求形态：GET /product/product-three/public/selectFabricByProductId，查询参数按契约放入 params.query（类型为 ProductFabricRequest）。
• 参数约定：tool 参数最外层仅包含嵌套对象 params；Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers。
• 登录态：若接口在当前租户/用户权限下需要鉴权，通过 params.accessToken 生成 Authorization: Bearer <token>；若传入值已含 Bearer 前缀则不再重复拼接。
• 结果处理：以接口原始响应为事实来源，向上层返回 ProductFabricsVO 相关字段；遇认证、权限、参数或业务错误时，应传递原始错误码与错误信息，便于编排层重试或换路。

适用边界与注意点

• 本技能 只完成单步查询，不串联库存、价格、订单或物流；多接口业务需由上层 Agent 按聚合 skill platform-3d-product-config 或计划文档编排多个原子 skill。
• 属于查询/计算类接口，仍受登录态、租户与用户权限约束；无权限时勿在本地「补造」面料列表或库存状态。
• 与聚合文档中的原始 action 名称一致：select_fabric_by_product，便于在更大配置技能树中定位与组合。