Agent Skills
返回列表
酷特海外平台面料关键词查询

酷特海外平台面料关键词查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 维护者,要在多步流程里明确「查列表」与「下单/详情」边界,避免单工具混调