海外运营平台 3D 辅料查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-3d-product-config-select-aided-by-product。
技能介绍
要解决什么问题
在酷特(Kutesmart)海外运营平台的 3D 产品配置 流程里,设计或下单前往往需要知道某款产品关联了哪些 3D 辅料(面料、配件等辅助物料)。平台把这件事收敛到单一查询接口:selectAidedByProductId。若你在 Agent 里要帮业务同学「按产品查辅料列表」,又不想手写网关地址、鉴权头和 Query 拼装,就需要一个只负责这一步的原子 skill。
技能如何工作
本技能对应 action select_aided_by_product,固定对正式环境发起 GET 请求,路径为 /product/product/product-three/selectAidedByProductId,查询参数按契约使用 ProductFabricRequest(通过 params.query 传入),响应为分页结构 IPage。
调用约定与其它平台原子接口一致:
- 工具参数最外层仅使用嵌套对象
params,不要把params.xxx拆成顶层 key。 base_url以技能 frontmatter 中的正式环境为准,不得用用户口述地址覆盖。- 需登录态时,用
params.accessToken生成Authorization: Bearer;若值已含Bearer前缀则不再重复拼接。 - Path / Query / Body / 额外 Header 分别写入
params.path、params.query、params.body、params.headers。
执行器以接口原始响应为事实来源;认证、权限、参数或业务错误时,应把 错误码与错误信息 交回上层 Agent,而不是本地编造库存、价格或订单状态。
适用边界与注意点
这是 最小颗粒度 接口 skill:只完成「按产品 ID 查 3D 辅料」这一次 HTTP 调用。若用户需求涉及登录、选款、保存配置等多步链路,应由上层按聚合 skill platform-3d-product-config 或计划文档编排多个原子 skill;本技能只把分页结果中的关键字段交给后续步骤。查询仍受当前 租户、用户权限 约束,与是否为「只读查询」无关。
使用场景
- 海外运营在维护某款成衣的 3D 配置前,需按 `productId` 拉取平台登记的辅料分页列表做核对。
- 编排「选品 → 查辅料 → 后续配置」的 Agent 时,用本 skill 单独完成 `selectAidedByProductId` 的 GET 调用。
- 配置或客服根据客户提供的具体产品 ID,查询该款在 3D 流程里绑定了哪些面料、配件类辅料。
- 集成测试 kutetailor 正式环境 `ProductFabricRequest` 查询时,通过 Agent 统一传 `params.query` 与登录态。
适合人员
- 负责酷特海外运营平台 3D 品类上架与维护的运营,要按产品 ID 核对辅料是否齐全。
- 正在拼装 `platform-3d-product-config` 多步链路的 Agent 开发者,需要可复用的辅料查询原子动作。
- 对接 kutetailor `/product-three/selectAidedByProductId` 的后端或集成工程师,希望在对话工具里调试分页返回。
- 海外业务侧产品配置专员,需要根据款号向系统确认当前款关联的 3D 辅料明细。