Agent Skills
返回列表
酷特海外工艺目录·按品类查刺绣

酷特海外工艺目录·按品类查刺绣

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-embroidery-by-category。

技能介绍

要解决什么问题

在海外运营平台的工艺目录里,刺绣往往挂在品类节点下:选品、报价或工艺说明时,需要先拿到「某个品类下有哪些刺绣」的权威列表。若让 agent 自己拼 URL、猜参数形态,容易和正式网关契约不一致,也会在多步链路里重复造轮子。

本技能是 platform-craft-catalog 聚合能力里的最小颗粒度接口之一,只负责动作 embroidery_by_category:按品类 ID 拉取刺绣列表,把接口原始响应交给上层继续编排。

技能如何工作

  • 固定正式环境:执行器使用 frontmatter 中的 base_url(https://www.kutetailor.com/api/craft/craft/craft-embroidery/selectEmbListByCategoryId),不接受用户输入覆盖地址。
  • 统一参数壳:tool arguments 最外层仅 params;Query 写入 params.query(本接口需要 categoryId);登录态用 params.accessToken 生成 Authorization: Bearer(值已含 Bearer 时不重复拼接)。
  • 请求形态:GET,查询参数挂在 URL query;返回以接口响应为唯一事实来源。

适用边界与注意点

  • 用户需求若包含登录、选租户、翻页其它目录节点等多步操作,本技能只完成本接口调用,后续步骤由上层 agent 或其它原子 skill 承接。
  • 接口返回认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,不要补造库存、价格、订单号等字段。
  • 仍需遵守当前登录态、租户与用户权限;查询类接口同样受权限约束。

使用场景

  • 海外定制流程里已确定 `categoryId`,需从酷特正式环境拉取该品类下可选刺绣列表,供后续选花型或报价步骤使用。
  • 上层 agent 编排 `platform-craft-catalog` 时,在品类节点解析完成后调用本接口,把刺绣枚举交给下一个原子 skill 处理。
  • 运营或技术支持排查「某品类下刺绣不全」时,用固定 GET `selectEmbListByCategoryId` 对照平台原始返回,避免凭记忆补数据。
  • 集成 kutetailor 工艺目录的多步对话中,仅需完成「按品类查刺绣」一步,其余登录、租户或其它目录接口由其它 skill 承接。

适合人员

  • 对接酷特海外运营平台工艺目录 API 的集成工程师,希望在 agent 里用统一 `params` 契约调用正式环境查询接口。
  • 负责定制选品或报价对话流的 agent 编排者,在用户选定品类后自动拉取刺绣列表而非手写 URL 与参数。
  • 海外业务侧工艺或品类维护同学,需通过 agent 触发接口核对某 `categoryId` 下刺绣配置是否与 kutetailor 一致。
  • 维护 `platform-craft-catalog` 聚合 skill 的实现与文档同学,将 `embroidery_by_category` 作为可复用原子步骤嵌入更长链路。