kutesmart 工艺目录-按编码品类查询

这个接口解决什么问题

工艺查询常常会同时依赖两个条件：一个是外部业务系统里的工艺编码，一个是后台维护的工艺品类。海外运营平台里，这两类信息又和登录态、租户、用户权限绑在一起，直接让 Agent 猜接口、拼参数很容易出现编码写错、品类传空、鉴权方式不一致的问题。

这个 skill 把动作收敛成一个可预测的接口调用：craft_by_ecode_category。当你已经拿到 craftCode 和 category，只需要问“按编码和品类查工艺”，它就会调用固定正式环境的查询接口，并把返回结果原样交给上层 Agent。

核心能力与调用步骤

这个技能是最小颗粒度的接口技能，只负责一个平台接口动作。它的核心能力是执行 GET /craft/craft/getCraftByEcodeAndCategory，查询参数固定为 craftCode 与 category。

调用时需要注意以下步骤：

• tool arguments 统一使用嵌套的 params 对象，最外层只放 params，不要使用 params.xxx 这类点号顶层 key。
• 正式环境地址固定在 frontmatter 的 base_url：GET https://www.kutetailor.com/api/craft/craft/craft/getCraftByEcodeAndCategory，调用时不要从用户输入覆盖。
• 登录态接口使用 params.accessToken 生成 Authorization: Bearer；如果传入值已含 Bearer，不要重复拼接。
• Path 参数写入 params.path，Query 参数写入 params.query，JSON Body 写入 params.body，额外 Header 写入 params.headers。
• POST/PUT 默认发送 JSON body；如果上层接口网关另有约定，以网关契约为准。

适用边界与注意点

这是查询或计算类接口，仍需遵守当前登录态、租户和用户权限。返回结果必须以接口响应为事实来源，不要补造库存、价格、订单号、优惠金额或物流状态。

如果接口返回认证、权限、参数或业务错误，应把原始错误码和错误信息传给上层 Agent。需要组合成完整业务链路时，由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。