海外面料辅料价格查询

要解决什么问题

在海外面料运营的业务里，价格查询是报价单、样品单和大货单流转的前置环节。运营同事、业务开发或客服同学经常需要根据面料编码快速确认该款对应的辅料价格，再把结果带入后续的报价与下单流程。如果每次都让大模型凭经验估算，容易出现价格口径不一致、库存或优惠信息幻觉等问题，直接影响报价的准确性和客户信任度。

这个技能只负责一件事：调用正式环境的辅料价格查询接口，把真实返回结果交给上层 agent。它不做完整的报价单生成，也不负责库存、优惠金额或物流状态的推断。

技能如何工作

核心能力是执行一个最小颗粒度的接口动作 aided_price，对应固定地址 GET https://www.kutetailor.com/api/fabric/fabric-aided-price/getAidedPrice。

调用时需注意以下关键点：

• 统一参数容器：所有 tool arguments 放进嵌套对象 params，最外层只出现 params，不要写成 params.xxx 这样的点号顶层 key。
• 地址不可覆盖：base_url 固定在 frontmatter 中，执行器只使用该正式环境地址，不接受用户输入覆盖。
• 鉴权方式：登录态接口通过 params.accessToken 生成 Authorization: Bearer；如果传入值本身已含 Bearer，不要重复拼接。
• 参数分流：Path 参数写入 params.path，Query 参数写入 params.query，JSON Body 写入 params.body，额外 Header 写入 params.headers。
• 方法约定：POST/PUT 默认发送 JSON body；若上层接口网关另有约定，以网关契约为准。
• 返回以接口为事实来源：不补造库存、价格、订单号、优惠金额或物流状态；查询类接口仍需遵守当前登录态、租户和用户权限。

当用户提出完整业务需求，例如「查询这款面料的辅料价格并生成报价建议」，本技能只完成接口调用这一步，把 RS 返回字段交给后续 skill 继续编排。

适用边界与注意点

• 不是聚合技能：它只是 platform-fabric-catalog 聚合 skill 的一个原子 action，不会自动串联多个接口。
• 不做业务解释：如果接口返回认证失败、权限不足、参数错误或业务错误，技能会把原始错误码和错误信息传给上层 agent，不做二次包装。
• 参数约束：Query 中只需要提供面料编码 code；其他返回字段是否可用取决于接口实际响应，不要自行假设。
• 调用环境：只指向正式环境；没有沙箱或测试地址，变更前需要在网关或权限侧做好评估。
• 编排位置：适合放在查询层或价格计算链路的起点，由上层 agent 按聚合 skill 或计划文档组织后续步骤。