Agent Skills
返回列表
酷特海外 3D 辅料查询

酷特海外 3D 辅料查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config-select-aided-by-product。

技能介绍

要解决什么问题

在海外运营平台的 3D 产品配置流程里,选款、面料与辅料往往要分步查数。若 Agent 直接拼 HTTP,容易搞错正式环境地址、把 Query 参数摊成顶层 params.xxx,或在未登录时仍发起查询。本技能把「按产品查 3D 辅料」收敛为单一动作 select_aided_by_product,只负责一次 GET 调用,把分页结果交给上层继续编排。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的正式环境 base_url,对应路径 /product/product-three/selectAidedByProductId,不接受用户输入覆盖域名。
  • 参数形态:tool arguments 最外层仅包含嵌套对象 params;Query 条件(ProductFabricRequest)写入 params.query;需登录时在 params.accessToken 生成 Authorization: Bearer(值已含 Bearer 则不重复拼接)。
  • 返回约定:以接口响应为准,返回类型为 IPage 分页结构;认证、权限、参数或业务错误时,应把原始错误码与信息向上传递,不要自行补造库存、价格或订单状态。
  • 编排定位:属于聚合 skill platform-3d-product-config 下的原子接口;多步业务(先选品再查辅料再改配置等)由上层 Agent 按聚合文档串联多个原子 skill。

边界与注意点

本技能只完成本接口,不替代完整配置链路。查询类接口仍受租户、用户权限与当前登录态约束;若用户需求跨越多个接口步骤,调用方应明确本步只交付辅料查询结果中的关键字段,后续步骤交给其它 skill 处理。

使用场景

  • 海外运营后台为某一成品 SKU 做 3D 配置时,需按产品 ID 拉取可用辅料分页列表再交给下一步选料
  • 编排 `platform-3d-product-config` 链路时,Agent 在本步只调用 `select_aided_by_product` 并解析 `IPage` 中的辅料记录
  • 客服或商品同事核对「某款产品绑定了哪些 3D 辅料」时,通过带登录态的 Query(`ProductFabricRequest`)发起查询
  • 对接 kutetailor 正式环境时,用固定 `base_url` 与嵌套 `params.query` 规范调用,避免手写 URL 拼错

适合人员

  • 负责酷特海外运营平台接口对接的后端,要把 3D 辅料查询封装进 Agent 工具链
  • 维护 `platform-3d-product-config` 聚合 skill 的编排作者,需要原子动作与错误上抛约定一致
  • 海外商品运营:在配置 3D 款号前,先按产品 ID 确认辅料清单是否与样衣资料一致
  • 实施顾问在客户环境联调 `selectAidedByProductId` 时,需区分本 skill 只做单步查询、不代跑完整配置