海外运营平台运费查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-shipping-manage-weight-price。
技能介绍
解决的问题
海外运营平台的运费查询接口需要按平台规范组装请求体、处理登录态和租户权限,手动调用容易在参数结构、认证头拼接和响应校验上出错。该技能把"获取运费"这一动作封装成原子接口调用,统一参数格式与认证逻辑,返回结果以接口响应为准,避免库存、价格、订单号等字段被错误填充。
工作原理
- 调用
POST https://www.kutetailor.com/api/shipping/shipping/getWeightPrice,请求体为SaveShippingVO,返回RS结构。 tool arguments统一使用嵌套的params对象:最外层只放params,不使用params.xxx这类点号顶层键;Path 参数写入params.path,Query 参数写入params.query,JSON Body 写入params.body,额外 Header 写入params.headers。- 登录态接口使用
params.accessToken生成Authorization: Bearer;若传入值已包含Bearer,不重复拼接。 - 参数列标明
application/json时按该格式提交,不强行改成普通 JSON。 - 执行器固定使用 frontmatter 中的正式环境地址,不接受用户输入覆盖
base_url。 - 返回结果直接使用接口响应,不补造库存、价格、订单号、优惠金额或物流状态;若接口返回认证、权限、参数或业务错误,将原始错误码和错误信息传给上层 agent。
适用边界
该技能是最小颗粒度接口技能,只负责平台接口动作 weight_price。当业务链路需要多个接口步骤时,由上层 agent 按聚合 skill 或计划文档编排多个原子 skill 完成。
使用场景
- 海外仓发货前需按重量段确认运费,调用该技能获取运费并核对报价是否符合预算。
- 运营配置发货渠道时,需要批量测算不同重量组合的运费,为每个组合调用该接口。
- 客服回复客户运费咨询时,需要即时调用运费接口获取最新报价,而非翻查价表。
- 上层 agent 编排完整发货流程时,在计费环节调用该技能获取运费,再传给后续步骤。
适合人员
- 海外运营平台的运营专员,需要在发货前快速确认各重量段运费。
- 负责对接发货管理系统的后端工程师,需要在集成运费查询接口时复用统一的调用格式。
- 客服团队成员,需要准确、即时回复客户关于运费的咨询。
- 搭建发货自动化流程的 agent 开发者,需要按计划编排原子接口完成运费计算。