酷特海外工艺目录 · 按 ID 查询
将以下提示词粘贴到你的 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 作为最小颗粒度能力供上层计划文档引用