Agent Skills
返回列表
酷特海外运营平台·工艺编码查询

酷特海外运营平台·工艺编码查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营或工艺主数据场景里,业务侧往往只有工艺编码(ecode),需要对照平台工艺目录拿到结构化记录,而不是凭编码猜名称或手工查后台。若 Agent 还要串订单、库存等多步接口,本 skill 只承担「按编码查一条工艺」这一步,把接口原样结果交给上层编排。

技能如何工作

本 skill 对应平台原子动作 craft_by_ecode,固定走正式环境 GET /craft/craft/getCraftByEcode,查询参数为 ecode。

调用约定(与同类 Kutetailor 原子 skill 一致):

  • 工具参数最外层仅使用嵌套对象 params,不要用 params.xxx 作为顶层 key
  • base_url 以 skill frontmatter 为准(https://www.kutetailor.com/api/craft/craft 路径体系),禁止用用户输入覆盖
  • 登录态:用 params.accessToken 生成 Authorization: Bearer …;若传入值已含 Bearer 前缀则不再重复拼接
  • Query 写入 params.query(本接口即 ecode);Path / Body / 额外 Header 分别用 params.path、params.body、params.headers

返回以 HTTP 响应体为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,便于上层重试或换链路。

适用边界

  • 最小颗粒度:不包含列表翻页、批量编码、工艺变更提交等;完整「工艺目录」能力见聚合 skill platform-craft-catalog
  • 仍需满足当前租户与用户权限;无 token 或权限不足时不会「补全」工艺内容
  • 不要根据返回字段臆造库存、价格、订单号、优惠或物流状态

使用场景

  • 客服收到客户提供的工艺编码,需在酷特海外运营平台核对对应工艺名称与属性后再回复
  • Agent 编排下单前,仅有 SKU 关联的 ecode,需先拉取工艺目录字段供后续定价或配置 skill 使用
  • 运营核对工艺主数据时,从 ERP 导出编码列表逐条调用接口校验平台侧是否存在且一致
  • 权限排查场景下,用已知 ecode 试调 GET 接口,区分是 token 失效还是编码不存在

适合人员

  • 对接酷特海外运营 API 的后端,要在 Agent 工具链里封装按 ecode 查工艺的固定 GET 调用
  • 海外定制/成衣运营,日常用工艺编码对平台目录做抽检或与内部 BOM 对照
  • 集成 platform-craft-catalog 聚合 skill 的 Agent 维护者,需要补齐 craft_by_ecode 这一原子步骤
  • 实施或二开顾问,在客户环境联调登录态与 query 参数 ecode 的传参规范