Kutesmart 海外运营平台面料标签查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-catalog-fabric-labels。
技能介绍
解决什么问题
海外运营平台中有面料目录时,运营、商品或客服常常要按标签筛选或核对面料信息。手工查询会散落在后台页面里,难以直接嵌到 agent 编排、批量核对或自动补全流程中。该技能把这类动作收敛成一个最小颗粒度接口调用:fabric_labels。它不负责完整的业务闭环,只确保“按 labelList 查面料标签”这一步能稳定、可复用地执行。
它如何工作
- 固定接口定位:正式环境调用地址固定为
GET https://www.kutetailor.com/api/fabric/fabric/getFabricLable,并由 SKILL.md frontmatter 中的base_url承载。执行时不接受用户输入覆盖环境地址,避免把预览、测试或其它租户环境混进链路。 - 统一参数模型:
tool arguments只放最外层params对象;不使用params.xxx这类点号顶层 key。登录态通过params.accessToken生成Authorization: Bearer;如果传入值已包含Bearer,不会重复拼接。 - 请求参数归位:Path 参数写入
params.path,Query 参数写入params.query,JSON Body 写入params.body,额外 Header 写入params.headers。当前 actionfabric_labels使用GET /fabric/getFabricLable,Query 为labelList,因此查询标签时按契约传入即可。 - 响应如实透传:返回结果以接口响应为事实来源,不会补造库存、价格、订单号、优惠金额或物流状态。若出现认证、权限、参数或业务错误,会保留原始错误码和错误信息,交给上层 agent 处理。
适用边界与注意点
- 单一动作技能:适合由上层 agent 组合进聚合 skill 或计划文档;多步骤业务链路需要由编排层拆分并串联多个原子 skill。
- 依赖登录态与权限:虽然是查询/计算类接口,仍需满足当前登录态、租户和用户权限。Token 缺失、过期或租户不匹配时,应按接口错误处理,而不是绕过校验。
- 遵循网关契约:POST/PUT 默认发送 JSON body;若上层接口网关另有约定,以网关契约为准。
- 不扩展返回语义:标签查询之外的需求,例如库存、价格、订单、优惠或物流状态,不在本技能范围内。
适用边界
- 最小颗粒度原子技能:仅封装单一接口动作,无法独立完成多步骤业务链路,需由上层 Agent 或聚合技能编排。
- 依赖外部网关契约:如果上层接口网关对请求体或响应格式另有约定,以网关契约为准,本技能不会自动绕过契约校验。
- 仅限面料标签查询:不提供库存、价格、订单号、优惠金额或物流状态等其他业务域的信息查询能力。
使用场景
- 运营在面料目录中按 `labelList` 核对面料标签,并把接口返回交给后续流程
- 上层 agent 在聚合技能中调用该接口完成单次面料标签查询
- 业务系统需要以 GET 请求拉取面料标签,遵守登录态、租户和权限约束
- 接口编排流程遇到认证、权限或参数错误时,需要透传原始错误码和信息
适合人员
- 海外运营平台的运营工程师,需要按标签核对面料目录
- 负责聚合多个原子技能的 agent 开发者,需要接入固定正式环境接口
- 平台 API 集成工程师,需要处理登录态、租户和权限透传
- 技术博客读者,关注最小颗粒度接口技能的设计和错误处理边界