Agent Skills
返回列表
酷特海外运营平台获取运费

酷特海外运营平台获取运费

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 流程设计人员