酷特海外运营平台·工艺编码查询
将以下提示词粘贴到你的 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 的传参规范