酷特海外工艺目录·工艺币种查价
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-craft-price。
技能介绍
要解决什么问题
在酷特海外运营平台(正式环境 https://www.kutetailor.com)里,报价、下单或工艺展示往往依赖「某个工艺 + 某种币种」的准确价格。若 Agent 自行拼 URL、混用 Path/Query/Body,或从用户话里改 base_url,很容易打到错误环境或丢登录态。
本技能是最小颗粒度的原子接口 skill,只负责 craft_price 这一动作:向 POST /craft/craft-price/listCraftPrice 提交 CalCraftPriceRequest,返回平台真实计价结果,供上层按聚合 skill 或计划文档继续编排。
技能如何工作
- 固定正式地址:执行器使用 frontmatter 中的
base_url,不接受用户输入覆盖。 - 统一参数形状:tool arguments 最外层仅含嵌套
params;Path →params.path,Query →params.query,Body →params.body,额外 Header →params.headers。 - 登录态:需 Bearer 时由
params.accessToken生成Authorization;值已含Bearer则不再重复拼接。 - Content-Type:参数列要求
application/json时按该格式提交请求体。 - 结果原则:价格、错误码、错误信息以接口响应为准,不补造库存、优惠或订单状态;认证/权限/参数/业务失败时把原始错误交给上层 Agent。
适用边界
- 只查价:用户仅需根据工艺 id 与币种查价时触发;多步业务(选工艺、算总价、下单)需组合其他原子 skill。
- 权限不变:查询/计算类接口仍受当前租户、用户与登录态约束。
- 归属:聚合 skill 为
platform-craft-catalog,原始 action 为craft_price。
使用场景
- 海外站点客服对话里,用户给出工艺编号并指定 USD/EUR,Agent 需调用 listCraftPrice 返回平台标价
- 编排「选工艺→算价→下单」链路时,上层 Agent 在拿到 craft id 与币种后单独触发 craft_price 取价
- 运营核对某批工艺在多币种下的目录价,按 id 列表循环查价并与后台导出结果对照
- 集成测试或联调脚本验证 CalCraftPriceRequest 入参与正式环境 `/craft-price/listCraftPrice` 响应字段
适合人员
- 维护酷特海外运营平台、需在 Agent 里对接 Kutetailor 正式 API 的内部集成工程师
- 编写 platform-craft-catalog 聚合 skill 的 Agent 作者,要把查价步骤拆成可复用的原子调用
- 海外定制/工艺业务运营,要在对话或工单系统里按工艺 id 与币种给出与线上一致的价格
- 负责海外站报价规则联调的 QA,需要用固定 base_url 与 Bearer 登录态复现查价接口