酷特海外平台 3D 价格计算
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config-do-3d-price。
技能介绍
要解决什么问题
在酷特海外运营平台里,定制类 3D 产品往往要先根据配置算价,再进入下单、库存或报价流程。若 Agent 直接拼 HTTP,容易搞错正式环境地址、把 params 摊成顶层点号字段,或在 Bearer 登录头上重复拼接前缀。本技能只做一件事:调用 do3dprice(POST /product/product/product-three/do3DPrice),把 3D 价格计算结果交给上层编排。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com),不接受用户输入覆盖。 - 参数形态:tool 参数统一放在嵌套
params里;Path →params.path,Query →params.query,Body →params.body(类型 C3DPriceRequest,application/json),额外 Header →params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer,不再重复拼接。 - 返回原则:以接口响应为准,不补造价格、库存或订单号;认证、权限、参数或业务错误时,把原始错误码与信息回传上层 Agent。
适用边界
这是 platform-3d-product-config 聚合链路中的原子 skill。用户若需要「查配置 + 算价 + 下单」等多步,本技能只完成算价一步;完整业务需按聚合 skill 或计划文档组合多个原子接口。
使用场景
- 海外定制流程里,客户已在平台完成 3D 产品配置,Agent 需在下单前调用 `do3DPrice` 取得官方报价。
- 编排 `platform-3d-product-config` 多步链路时,本步只负责提交 `C3DPriceRequest` 并把手算价结果交给后续下单或库存 skill。
- 销售或客服助手在对话中汇总 3D 配置参数,向 `kutetailor.com` 正式环境发起一次 POST 算价,避免人工估错价。
- 集成测试或联调阶段,需要验证 `accessToken` 与 JSON Body 格式是否符合平台对 `do_3d_price` 的约束。
适合人员
- 对接酷特海外运营平台 REST 的集成工程师,希望 Agent 固定正式 `base_url` 且用嵌套 `params` 调算价接口。
- 编写定制报价多步 Agent 的后端开发,需要在「3D 配置」与「下单」之间插入可复用的原子算价 skill。
- 海外站运营或售前支持,需在客户咨询时根据实时 3D 配置拉取平台定价结果用于回复或录单。
- 维护 `platform-3d-product-config` 聚合 skill 的编辑者,需要与原始 action `do_3d_price` 对齐的最小粒度能力。