Agent Skills
返回列表
酷特海外工艺目录 · 按 ID 查询

酷特海外工艺目录 · 按 ID 查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营或定制业务里,工艺(craft)往往挂在平台工艺目录上,下游排产、报价、展示都要先拿到某一条工艺的权威字段。人工查后台或拼多个文档里的 URL,既慢又容易把测试地址当成正式环境。

本 skill 只做一件事:在固定正式环境上,用工艺 id 调 craft_by_id,把接口原样结果交给上层 Agent。若你的需求是「查目录 + 改状态 + 下单」等多步链路,这里只负责「按 id 查」这一步。

技能如何工作

  • 单一 action:craft_by_id,对应 GET /craft/craft/getCraftById/{id},Path 参数 id 写在 params.path。
  • 调用约定:tool 参数最外层只放 params;正式环境 base_url 来自 skill frontmatter(https://www.kutetailor.com/api/craft/craft),不得用用户输入覆盖。
  • 登录态:需要时在 params.accessToken 里传 token,生成 Authorization: Bearer …;若已带 Bearer 前缀则不再重复拼接。
  • 返回原则:以接口响应为事实来源,不补造库存、价格、订单号等字段;认证、权限、参数或业务错误时,把原始错误码与信息向上传递。

适用边界与注意点

这是 platform-craft-catalog 聚合能力里的最小颗粒度接口 skill(原始 action:craft_by_id)。查询/计算类接口仍受当前登录态、租户与用户权限约束;GET 的 query 走 URL,本接口主要依赖 Path 中的 id。编排多个原子 skill 时,由上层 Agent 按聚合 skill 或计划文档串联。

使用场景

  • Agent 在编排定制下单或报价前,需用客户或订单里给出的工艺 id 拉取平台侧单条工艺定义
  • 客服处理海外定制咨询时,要把用户报出的工艺编号对照 kutetailor 正式环境的目录字段
  • 实施同学把 platform-craft-catalog 拆成多步时,本步只负责校验 id 并返回 RS,供后续 skill 消费
  • 运维或集成脚本在增量同步工艺主数据时,按已知 id 定点查询而非全量拉列表

适合人员

  • 对接酷特海外运营平台 HTTP 接口的后端工程师,希望在 Agent 工具链里固定走正式环境按 id 查工艺
  • 为客户上线定制业务流程的实施顾问,需要可编排的原子 skill 完成 craft_by_id 单接口调用
  • 海外定制业务运营,在对话或自动化流程里根据工艺 id 核对名称、参数等目录信息而少登后台
  • 维护 platform-craft-catalog 聚合 skill 的平台开发,将 craft_by_id 作为最小颗粒度能力供上层计划文档引用