Agent Skills
返回列表
酷特海外工艺价格批量查询

酷特海外工艺价格批量查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 鉴权约定