酷特海外 3D 辅料查询
将以下提示词粘贴到你的 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 只做单步查询、不代跑完整配置