酷特海外面料目录查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-catalog-fabric-info-by-code。
技能介绍
要解决什么问题
在海外运营或门店选料场景里,业务方往往只知道面料编码、品类或门店代码中的一组条件,需要把平台侧已维护的面料目录条目拉回来,供报价、备货或客服核对。若让 Agent 直接拼 URL、混用 Query 与鉴权头,很容易踩到环境地址被误改、Bearer 重复拼接等问题。
技能如何工作
本技能是酷特海外运营平台上的最小颗粒度接口封装,只执行 fabric_info_by_code 这一动作:对正式环境发起 GET /fabric/selectFabricInfoByCode,通过 params.query 传入 code、category、storeCode,并以 params.accessToken 生成 Authorization: Bearer 请求头。
调用约定上,tool 参数最外层仅包含 params;Path、Query、Body、额外 Header 分别落在 params.path、params.query、params.body、params.headers。执行器使用 frontmatter 中的固定 base_url,不接受用户输入覆盖正式环境地址。返回内容以接口响应为准,不把库存、价格、订单号等字段「补全」;若出现认证、权限或参数错误,应把原始错误码与信息交给上层 Agent 继续编排。
适用边界
- 仅需单步查询面料信息时直接使用;多接口串联(例如先选门店再批量查料)应由聚合 skill 或计划文档组合多个原子 skill。
- 仍受当前登录态、租户与用户权限约束,查询类接口不代表可绕过业务授权。
- 所属聚合能力为
platform-fabric-catalog,与文档doc/skill/platform-fabric-catalog/SKILL.md中的同一fabric_info_by_codeaction 对齐。
使用场景
- 客服收到客户提供的面料编码与门店编号,需在对话中核对平台面料目录条目是否匹配该门店与品类。
- 海外运营 Agent 在报价前根据 `category` 与 `storeCode` 拉取单条面料信息,再把返回字段交给后续定价或库存 skill。
- 门店选料流程里用户只给出品类与门店,编排层调用本接口补齐 `code` 对应的面料属性后再生成备货建议。
- 集成测试或联调时,验证 `selectFabricInfoByCode` 在正式环境固定地址下的 Query 参数与鉴权头是否符合网关契约。
适合人员
- 负责酷特海外运营平台 Agent 编排的后端工程师,需要把按码查面料做成可复用的原子 skill。
- 对接 Kutetailor 面料目录的电商或 OMS 集成同学,要在多步流程里单独完成「品类/门店查料」这一步。
- 海外门店运营或商品同事,通过内部助手按门店代码与品类核对面料档案而非手工登后台翻页。
- 平台运维或实施人员,在客户环境联调时复现认证失败、权限或参数错误并向上层 Agent 透传原始报错。