海外工艺目录批量查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-craft-catalog-craft-list。
技能介绍
要解决的问题
在 Kutesmart 海外运营平台的工艺目录场景里,上层 Agent 或业务系统常常需要一次拿到多个工艺的详情。如果没有统一的调用封装,每个调用方都要自己拼 craftIds、处理认证头、拼接正式环境地址,还要面对「这批工艺里哪些查到了、哪些不存在」这类分散返回,最后很容易各写一套、口径不一致。
这个技能做了什么
platform-craft-catalog-craft-list 只负责一件事:调用 craft_list 这个 GET 接口。
- 固定入口:正式环境地址写死在 frontmatter 的
base_url里,固定为GET https://www.kutetailor.com/api/craft/craft/craft/getCraftList,不接受用户输入覆盖,避免误打到测试环境。 - 统一参数载体:所有 tool arguments 都放在嵌套的
params对象里,不在最外层出现params.xxx这类点号 key。 - 登录态透传:通过
params.accessToken生成Authorization: Bearer;如果传入值本身已含Bearer,不再重复拼接。 - 参数归位:路径参数进
params.path,查询参数进params.query(craftIds就放在这里),JSON 体进params.body,额外请求头进params.headers。 - 以接口返回为准:结果直接透出接口响应,不补造库存、价格、订单号、优惠金额或物流状态。
适用边界与注意点
- 这是最小颗粒度的原子技能,只完成本接口调用。需要组合完整业务链路时,要由上层 Agent 按聚合 skill 或计划文档编排多个原子技能。
- 虽然这是查询类接口,仍受当前登录态、租户和用户权限约束。
- 遇到认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 Agent,不要吞掉或改写。
- 后续字段如果还有加工需求,建议按步骤索要,而不是一次把链路做完。
使用场景
- 在 Kutesmart 海外运营平台配置定制品时,需根据传入的工艺 ID 列表一次性拉取多个工艺详情。
- 上层 Agent 编排业务链路时,需调用本接口获取工艺数据,并将原始返回交给后续原子技能处理。
- 业务系统在生成海外订单工艺清单前,需传入多个工艺 ID 调用接口以获取最新工艺信息。
适合人员
- 负责 Kutesmart 海外平台对接的后端工程师,需要封装工艺批量查询接口并确保基础地址不被覆盖。
- 编排 Kutesmart 业务链路的 Agent 开发者,需要获取接口原始响应以串联后续工艺处理步骤。
- 处理海外定制品订单的业务系统开发者,需要通过工艺 ID 列表获取准确的工艺目录数据。