面料标签查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-catalog-fabric-by-label。
技能介绍
解决什么问题
海外运营平台中,面料资料不是只有一条静态列表,而是会挂在不同业务标签下。运营同学在前端筛选某个标签时,后端需要把该标签关联的面料取回来;如果让每个调用方自己拼 URL、加登录态、处理错误,链路很容易分叉。这个 skill 只解决其中一件事:接收 labelId,调用面料目录的标签查询接口,把接口返回交给上层 agent。
核心能力与调用方式
- 动作:
fabric_by_label,请求方法固定为GET。 - 正式地址:
https://www.kutetailor.com/api/fabric/fabric/label-table/selectFabricByLabel,来自 frontmatter 的base_url,不接受用户输入覆盖。 - 查询参数写入
params.query,标签 ID 为labelId。 - 登录态通过
params.accessToken传入;若值本身已带Bearer,不要重复拼接,最终放入Authorization: Bearer ...。 - Path、JSON Body、额外 Header 分别使用
params.path、params.body、params.headers,保持嵌套参数结构。 - 这是查询/计算类接口,仍必须遵守当前登录态、租户和用户权限。
适用边界与注意点
它属于最小颗粒度原子 skill,不是完整业务编排器。当用户需要多个接口步骤时,本 skill 只完成自己的调用,并把关键返回字段交给后续 skill;聚合编排应由上层 agent 或聚合 skill 负责。
返回结果必须以接口响应为事实来源。不要因为字段名相似就补造库存、价格、订单号、优惠金额或物流状态。若接口返回认证、权限、参数或业务错误,应把原始错误码和错误信息透传给上层 agent,而不是改写成成功结果。
使用场景
- 运营在后台按业务标签筛选面料时,需要根据 labelId 获取该标签下的面料清单。
- 上层 agent 做面料资料聚合时,需要先把标签维度的面料结果取回再交给后续步骤。
- 内容团队在搭建面料查询入口时,需要按标签返回结构化面料数据用于页面渲染。
- 排查标签筛选异常时,需要通过该接口确认返回码和错误信息来判断是权限还是参数问题。
适合人员
- 海外运营平台的运营人员,需要按标签快速定位并核对面料资料。
- 负责面料目录功能的开发工程师,需要明确单个接口的请求参数与错误返回。
- 构建面料查询流程的 agent 工程师,需要按原子能力组合多个步骤完成业务链路。
- 审核平台权限的管理员,需要确认标签查询是否遵循登录态和租户隔离。