酷特海外工艺目录·按品类查刺绣
将以下提示词粘贴到你的 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` 作为可复用原子步骤嵌入更长链路。