Agent Skills
返回列表
海外运营平台 3D 辅料查询

海外运营平台 3D 辅料查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 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 辅料明细。