Kutesmart 海外分销面料价格查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-member-finance-distribution-fabric-price。
技能介绍
要解决什么问题
海外运营平台对接的分销商数量一多,手动到后端页面逐个翻面料报价就变得既慢又容易出错。报价延迟、价格口径不一致,最终会传导到订单转化环节。这个技能把「按会员和面料编码查分销价」这一动作封装成一个可直接调用的接口 skill,让 agent 能在同一会话里完成查询,无需人工跳转页面或导出表格。
它如何工作
核心能力是调用 KuteSmart 的分销面料价格查询接口,属于 platform-member-finance 聚合技能下的最小颗粒度原子 skill。关键步骤如下:
- 查询条件:需要传入
memberId(分销商会员 ID)和fabricCode(面料编码),两者均为必填查询参数。 - 调用方式:使用 GET 请求,固定地址
https://www.kutetailor.com/api/member/distribution/fabric-price/getByCode,该地址由 frontmatter 的base_url固定注入,不接受用户输入覆盖。 - 参数映射:认证信息通过
params.accessToken生成Authorization: Bearer头;路径变量写入params.path,查询参数写入params.query,附加头写入params.headers。最外层统一用嵌套params对象,不允许出现params.xxx这类点号顶层 key。 - 响应处理:接口返回字段以原始响应为准,不做补造或扩展。如果出现认证、权限、参数或业务错误,原样回传错误码和错误信息,不吞异常。
适用边界
- 本 skill 只提供查询动作,不负责获取 access token、不拼接列表页、不处理多面料批量报价,也不做价格与订单金额的关联计算。这些需要上层 agent 通过聚合 skill 或计划文档编排其他原子 skill 完成。
- 返回的价格是查询时点的快照,不包含库存、优惠或物流状态。若业务需要版本化报价或价格生效区间,需由上层逻辑另行处理。
- 调用受当前登录态、租户和用户权限约束,跨租户查询或未授权会员会返回权限错误。
使用场景
- 海外运营人员需为分销商会员查询指定面料编码的当前报价
- 客服处理分销商询价时需按面料编码拉取最新价格
- 财务核对分销面料价格记录时需调用接口获取原始返回
- 业务方搭建自动化报价链路时需先获取单面料价格接口数据
适合人员
- 海外运营平台运营人员,需要按会员与面料编码快速获取分销报价
- 跨境面料分销客服,需要在对话中即时查询分销价格
- 对接运营平台的后端开发,需要了解查询面料价格的接口参数与调用约束
- 运营平台财务或对账人员,需要拉取分销面料价格原始数据做核对