Kutesmart简定制实时报价

解决什么问题

简定制场景下，订单价格需要随设计变量（例如样式、数量、配件）实时计算。手工对接该计算接口时，团队通常面临三类问题：

• 平台侧参数契约复杂，客户端容易把 path、query、body、headers 混用；
• 正式环境地址和登录态需要固定配置，难以避免被上层输入覆盖；
• 计算失败时，上层 agent 缺少结构化错误，无法快速区分认证、权限、参数或业务问题。

该技能把简定制实时计算价格拆成一个可复用的原子接口动作，便于在更大的下单流程中组合调用。

技能如何工作

技能只承担一个平台接口动作：style_design_price。

• 使用固定的正式环境地址：POST https://www.kutetailor.com/api/order/order/orden/getStyleDesignPrice；
• tool arguments 统一使用嵌套的 params 对象；
• 最外层只放 params，不要把 params.xxx 展开成顶层 key；
• base_url 固定写在 frontmatter，不从用户输入覆盖；
• 登录态接口使用 params.accessToken 生成 Authorization: Bearer，如果传入值已包含 Bearer，不要重复拼接；
• params.path 放路径参数，params.query 放查询参数，params.body 放 JSON Body，params.headers 放额外 Header；
• 参数列标明 application/json，请求体按该格式提交；
• 该接口属于查询或计算类接口，但仍需要遵守当前登录态、租户和用户权限。

接口行为如下：

• action：style_design_price；
• request：POST；
• URL：/order/orden/getStyleDesignPrice；
• Body：SaveStyleOrdenVO；
• 返回：StyleDesignPrice；
• 用途：简定制实时计算价格。

适用边界与注意点

这个技能是最小颗粒度接口 skill，只负责调用简定制实时计算价格接口。

• 如果用户需求包含多个接口步骤，本技能只完成当前接口调用，并把关键返回字段交给后续 skill；
• 上层 agent 需要按聚合 skill 或计划文档编排多个原子 skill，才能形成完整业务链路；
• 返回结果必须以接口响应为事实来源，不要补造库存、价格、订单号、优惠金额或物流状态；
• 接口返回认证、权限、参数或业务错误时，需要把原始错误码和错误信息传给上层 agent；
• 适合需要实时获取设计价格、并将价格结果接入下游编排的场景，不适合替代完整下单流程。