酷特海外运营平台获取运费
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-weight-price。
技能介绍
要解决什么问题
在酷特海外运营平台做发货前,业务侧往往要先知道当前包裹/线路对应的运费。若由 Agent 直接拼 HTTP,容易踩坑:正式环境地址被用户输入覆盖、登录态 Authorization 重复加 Bearer、或把 Path/Query/Body 摊成顶层点号 key,导致网关或权限校验失败。
本 skill 是最小颗粒度的 weight_price 动作:只负责调用 POST /shipping/shipping/getWeightPrice,把接口原样返回交给上层;完整「查价 → 下单 → 发货」需由聚合 skill 或计划文档编排多个原子 skill。
技能如何工作
- 固定使用 frontmatter 中的正式环境基址:
https://www.kutetailor.com,不接受用户覆盖base_url。 - 工具参数统一放在嵌套对象
params内:params.body提交SaveShippingVO(application/json);需登录时在params.accessToken生成Authorization: Bearer(已含Bearer则不重复拼接)。 - 执行器按表选择 POST 与路径;Path/Query/Header 分别写入
params.path、params.query、params.headers。 - 返回以接口响应为准:不补造价格、订单号或物流状态;认证、权限、参数或业务错误时,把原始错误码与错误信息传给上层 Agent。
适用边界与注意点
- 触发场景:用户明确需要「获取运费」时使用;若需求跨多接口,本 skill 只完成本步并把关键字段留给后续 skill。
- 仍是查询/计算类接口,须遵守当前登录态、租户与用户权限。
- 最外层 tool arguments 只放
params,不要使用params.xxx这类点号顶层 key。
使用场景
- 在海外运营平台正式开发货单前,Agent 根据 `SaveShippingVO` 调用 getWeightPrice,向运营展示系统计算的运费。
- 上层编排「发货管理」多步流程时,本步只负责拉取运价,把接口返回的关键金额字段交给后续创建或提交步骤。
- 客服处理买家「这单运费多少」咨询时,按当前登录租户权限提交 Body,以平台响应为准回复报价。
- 集成测试或联调时,验证 accessToken、租户权限与 JSON Body 格式是否正确,并核对错误码是否原样回传 Agent。
适合人员
- 负责酷特 kutetailor 海外店铺履约、开单前必须用平台接口核对运价的运营或仓储发货人员
- 对接 `/shipping/getWeightPrice`、在 Agent 里封装 weight_price 原子调用的后端或系统集成工程师
- 处理海外订单物流费用问题、需要按 SaveShippingVO 查官方运价再答复买家的客服或履约协调员
- 维护 platform-shipping-manage 聚合 skill、需把「获取运费」拆成独立原子步骤的方案或 Agent 流程设计人员