酷特海外平台面料图片路径查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-catalog-fabric-path。
技能介绍
要解决什么问题
在海外运营或商品展示链路里,页面、报表或下游 skill 往往只有面料编码,却需要拿到可访问的面料图片路径才能拼 CDN、详情页或打印物料。手工查后台或复制链接既慢,也容易和正式环境数据不一致。
本 skill 是酷特海外运营平台「面料目录」聚合能力里的原子接口 skill,只负责一次动作:fabric_path——按编码向正式环境查询图片路径,并把接口原样返回交给上层编排。
如何工作
- 固定端点:执行器使用 frontmatter 中的正式环境地址
GET https://www.kutetailor.com/api/fabric/fabric/selectPathByCode,不接受用户输入覆盖base_url。 - 入参:tool arguments 最外层仅包含嵌套对象
params;本接口在params.query中传code(面料编码)。需登录态时在params.accessToken传入 token,生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 返回:成功时得到 String 类型的图片路径;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,由 agent 决定重试或换路。
适用边界与注意点
- 若用户需求涉及目录列表、库存、价格等多步操作,本 skill 只完成路径查询;完整业务需由上层 agent 按聚合 skill
platform-fabric-catalog或计划文档组合多个原子 skill。 - 返回必须以接口响应为事实来源,不要臆造路径、库存或订单类字段。
- 查询类接口仍受当前登录态、租户与用户权限约束;无权限时以接口错误为准处理。
使用场景
- 商品详情或样册排版时,手里只有面料编码,需要向正式环境换取可引用的面料图片路径字符串。
- 编排 `platform-fabric-catalog` 多步链路时,前一步已得到 `code`,本步专门调用 `fabric_path` 取图址交给展示 skill。
- 海外运营后台导出的面料编码清单,批量由 agent 逐条查路径并写入内部 CMS 或 CDN 映射表。
- 客服或销售在对话里给出面料号,需要在不打开后台的前提下确认该面料当前绑定的图片地址。
适合人员
- 负责酷特海外站面料上架、需在编码与展示图 URL 之间做自动对齐的商品运营
- 对接 kutetailor.com 正式环境、把 `selectPathByCode` 封装进 agent 工具链的后端或集成工程师
- 编写面料目录聚合 skill 的上层 agent 维护者,需要可靠的原子 `fabric_path` 步骤
- 用面料编码驱动报表或打印物料、缺路径就无法出图的设计或供应链协同同事