Agent Skills
返回列表
酷特海外平台工艺目录批量查询

酷特海外平台工艺目录批量查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营或定制业务系统里,工艺(craft)往往分散在平台目录中。上层 Agent 若要在一次对话里核对多条工艺 ID 对应的名称、属性或状态,就需要调用酷特海外运营平台的批量查询工艺接口,而不是让用户手工在后台逐条查找。

本技能是最小颗粒度的原子接口技能,只负责 craft_list 这一动作;完整下单、改价、库存等链路需由上层按聚合 skill 或计划文档组合多个原子 skill。

技能如何工作

  • 固定环境:执行器使用 frontmatter 中的正式环境 base_url(GET https://www.kutetailor.com/api/craft/craft/craft/getCraftList),不接受用户输入覆盖地址。
  • 调用形态:tool 参数统一放在嵌套对象 params 中;Query 参数 craftIds 写入 params.query;需登录时在 params.accessToken 中传 token,生成 Authorization: Bearer(若已含 Bearer 则不重复拼接)。
  • 返回原则:以接口响应为唯一事实来源,不补造库存、价格、订单号等字段;认证、权限、参数或业务错误时,将原始错误码与信息交给上层 Agent 处理。

适用边界与注意点

  • 仅适用于「按 ID 批量查工艺目录」;若需求涉及多步接口(创建、更新、关联物料等),本技能只完成本步并把关键字段交给后续 skill。
  • 属于查询类接口,仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实透传平台错误,而非在本地猜测结果。

使用场景

  • 客服工单里拿到一串工艺 ID,需要在对话中批量核对名称与属性后再回复客户
  • 定制业务 Agent 从订单或 BOM 解析出多个 craftIds,调用接口拉取工艺明细供下一步定价或排产 skill 使用
  • 海外运营同学在后台改目录前,让 Agent 按 ID 列表一次性校验平台侧当前工艺记录是否存在
  • 聚合 skill 编排链路中的单步:仅负责 getCraftList,把返回字段交给后续创建或关联物料的接口 skill

适合人员

  • 对接酷特 kutetailor 正式环境的集成工程师,需要在 Agent 里封装 getCraftList 查询
  • 海外运营平台负责工艺主数据的运营,经常要把 Excel 或工单里的 ID 批量对照平台目录
  • 搭建 platform-craft-catalog 聚合链路的产品/Agent 设计同学,需要选用原子 craft_list skill
  • 定制服装或智能制造业务里,用对话式工具核对工艺编码与平台目录一致性的业务实施人员