酷特海外平台面料关键词查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-catalog-fabric-list。
技能介绍
要解决什么问题
在酷特海外运营平台(正式环境 https://www.kutetailor.com)里,业务侧经常需要按关键词检索面料目录,而不是手工翻页或拼错 Query。上层 Agent 若把「登录、分页、下单」和「查列表」混在一个大工具里,失败时很难定位是参数问题还是权限问题。本 skill 只做一件事:调用 fabric_list,把接口原样结果交给后续步骤。
技能如何工作
这是 platform-fabric-catalog 聚合能力里的最小颗粒度接口 skill,对应原始 action fabric_list。
- 固定端点:执行器必须使用 frontmatter 中的正式环境
base_url,调用GET /fabric/listFabricInfo(完整地址为GET https://www.kutetailor.com/api/fabric/fabric/listFabricInfo),不接受用户输入覆盖 base_url。 - 参数约定:tool arguments 最外层只放嵌套对象
params;Query 写入params.query(如keywords等);需登录时在params.accessToken生成Authorization: Bearer(值已含Bearer则不再拼接)。 - 返回原则:以接口响应为事实来源,不补造库存、价格、订单号或物流状态;认证、权限、参数或业务错误时,把原始错误码与信息传给上层 Agent。
适用边界
- 只做本步:用户若要「关键词查列表 + 详情 + 下单」等多接口链路,本 skill 只完成列表查询;编排见聚合 skill 文档
doc/skill/platform-fabric-catalog/SKILL.md。 - 权限不变:查询类接口仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实上报错误而非猜测数据。
使用场景
- 客户邮件里给出面料名称片段,需要在酷特正式环境里按 `keywords` 查出候选面料列表再人工核对
- 编排 `platform-fabric-catalog` 链路时,先调用本 skill 拿列表,再把返回字段交给详情或选料后续 skill
- 海外运营在对话里描述「要找某类克重/成分的面料」,Agent 用本接口拉列表而非臆造 SKU
- 集成报价助手:用户输入检索词后,仅执行 `GET /fabric/listFabricInfo` 一步并把 RS 原样交给上层
适合人员
- 负责酷特海外面料询价的运营,希望 Agent 按客户关键词直接对接正式环境列表接口
- 正在拆分 `platform-fabric-catalog` 的集成工程师,需要独立的 `fabric_list` 原子 skill 便于编排与排错
- 把酷特面料能力接到内部助手的后端开发,诉求是参数走 `params.query`、错误码原样回传
- 定制业务 Agent 维护者,要在多步流程里明确「查列表」与「下单/详情」边界,避免单工具混调