酷特海外工艺价格批量查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-craft-price-by-ids。
技能介绍
要解决什么问题
在海外运营或报价流程里,工艺项往往很多,逐个查价既慢又容易和平台侧数据不一致。上层 agent 若直接拼 HTTP,还要处理固定正式环境地址、Authorization: Bearer 与统一的 params 结构,出错点集中在参数层级和登录态拼接上。
技能如何工作
本技能是最小颗粒度原子接口,只执行 craft_price_by_ids 一次调用:
- 方法与环境:
POST固定指向正式环境https://www.kutetailor.com/api/craft/craft-price/listCraftPriceByIds(来自 frontmatter 的base_url,调用时不得被用户输入覆盖)。 - 请求体:JSON Body 放在
params.body,按接口要求提交craftIds(application/json)。 - 鉴权:通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer前缀则不再重复拼接。 - 参数约定:最外层仅使用嵌套对象
params;Path / Query / Body / 额外 Header 分别写入params.path、params.query、params.body、params.headers,避免params.xxx这类点号顶层 key。 - 返回与错误:以接口响应为事实来源,不补造价格、库存或订单类字段;认证、权限、参数或业务错误时,将原始错误码与信息交给上层 agent 编排后续步骤。
完整业务链路(例如先查目录再算价)需由上层按聚合 skill platform-craft-catalog 或计划文档组合多个原子 skill;本技能只完成「按 ID 批量查工艺价格」这一步。
适用边界与注意点
- 仅覆盖批量查询工艺价格,不包含工艺目录浏览、下单或物流等接口。
- 仍为查询类接口,但受当前登录态、租户与用户权限约束;无权限时不会「推断」价格。
- 若用户需求跨多接口,请明确本技能只交付本接口关键字段,其余步骤交给后续 skill。
使用场景
- 海外报价 agent 已拿到一批工艺 ID,需调用正式环境接口批量取回价格并写入客户报价单。
- platform-craft-catalog 编排中,目录查询返回 craftIds 后,用本 skill 一次性补齐各工艺价格字段。
- 运营核对定制方案时,按多个工艺编号批量查询平台当前价,与内部报价表或历史单据比对。
- 对话里用户只提供 craftIds 列表,上层 agent 需直连 listCraftPriceByIds 获取权威价格再回答。
适合人员
- 对接酷特 kutetailor 正式 API、在 agent 计划里串联「目录 + 批量查价」的后端或集成工程师
- 维护海外定制报价流程、经常手握工艺 ID 列表向平台批量核价的运营或报价专员
- 设计企业运营类 agent 的解决方案架构师,需要将 craft_price_by_ids 作为原子步骤写入编排文档
- 为上层聚合 skill 编写调用规范的技术写作者,需明确 params.body 与 Bearer 鉴权约定