海外运营面料关键词查列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-catalog-fabric-list。
技能介绍
要解决什么问题
在海外运营与定制业务里,选料往往从「按关键词搜面料」开始:运营、客服或上层 Agent 需要拿到平台侧的真实面料列表,而不是凭记忆拼 SKU 或名称。若把整段业务流程塞进一个巨型工具,参数形态和错误处理会很快失控。
本技能是 最小颗粒度 的接口 skill,只负责平台动作 fabric_list:在固定正式环境上,用关键词等方式查询面料列表,并把接口返回作为事实来源交给后续步骤(详情、库存、下单等由其它原子 skill 或聚合编排完成)。
如何工作
- 固定端点:执行器使用 frontmatter 中的正式环境地址
GET https://www.kutetailor.com/api/fabric/fabric/listFabricInfo,不接受用户输入覆盖base_url。 - 统一参数壳:
tool arguments最外层只放嵌套对象params;Query 写入params.query(如keywords等),Path 写入params.path,Body 写入params.body,额外 Header 写入params.headers。 - 登录态:需要鉴权的调用通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀,不再重复拼接。 - 返回与错误:以接口响应为准,不补造库存、价格、订单号等字段;认证、权限、参数或业务错误时,应把原始错误码与错误信息传给上层 Agent。
适用边界
- 仅覆盖 关键词查面料列表 这一步;多接口链路请组合
platform-fabric-catalog等聚合 skill 或按计划文档编排。 - 属于查询类接口,仍受当前登录态、租户与用户权限约束;网关若对 POST/PUT Body 另有约定,以网关契约为准。
使用场景
- 客服收到客户描述的布料名称,需在酷特海外平台用关键词拉取可售面料列表再核对货号
- 上层 Agent 编排选料流程时,先调用本接口按 keywords 查询,再把列表交给详情或下单类 skill
- 商品运营维护海外面料库时,用固定正式环境接口抽检关键词检索结果是否与后台一致
- 集成 platform-fabric-catalog 聚合链路时,将 fabric_list 作为选料链路的第一个原子查询步骤
适合人员
- 负责酷特海外定制业务、需在对话或工单里按客户描述查平台面料列表的客服与运营
- 正在把 platform-fabric-catalog 拆成原子 skill 并统一 `params` 入参的后端或集成工程师
- 需要让 Agent 只调用单一 GET 动作、且禁止改写 base_url 的 Skill 维护者
- 海外商品同学在做面料上架或文案校对时,要对照正式环境关键词检索返回的 RS 字段