Agent Skills
返回列表
酷特海外物流运单识别快递公司

酷特海外物流运单识别快递公司

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-list-shipping-express。

技能介绍

要解决什么问题

海外运营里经常只有一串运单号,系统或客服需要先知道对应快递公司才能对接轨迹、工单或售后。手工对照规则表既慢又容易错;若整条链路还要查库存、改地址,也不该把「识别承运商」和别的接口绑在一个大工具里。

本技能对应酷特海外运营平台的最小粒度动作:list_shipping_express。上层 Agent 在编排「物流查询」聚合能力时,可单独调用它,再把返回里的关键字段交给后续步骤。

技能如何工作

  • 固定端点:正式环境为 POST https://www.kutetailor.com/api/shipping/shipping/listShippingExpress,由技能 frontmatter 的 base_url 决定,不得用用户输入覆盖。
  • 请求体:application/json,Body 字段为 waybillNoList(运单号列表)。
  • 参数封装:工具参数统一放在嵌套对象 params 下;Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers。
  • 登录态:通过 params.accessToken 生成 Authorization: Bearer <token>;若传入值已含 Bearer 前缀,勿重复拼接。
  • 返回:以接口原始响应为准,用于识别快递公司;不自行补造物流状态、订单号或金额等字段。

适用边界与注意点

  • 仅完成「根据运单号识别快递公司」这一步;多接口业务流程由上层按聚合 skill 或计划文档串联其它原子 skill。
  • 仍受租户、用户权限与当前登录态约束;认证、权限、参数或业务错误应把原始错误码与错误信息向上传递,便于 Agent 重试或改参。
  • 最外层 tool arguments 只放 params,不要使用 params.xxx 这类点号形式的顶层 key。

使用场景

  • 客服工单里只有客户发来的运单号,需要先识别快递公司再拉轨迹或转对应承运商页面
  • 编排 platform-shipping-query 时,把运单号列表交给本接口,用返回的承运商信息驱动下一步查询
  • 海外仓发货导出只有 tracking 列、缺少 carrier 字段,批量写入 waybillNoList 做承运商补全
  • 上层 Agent 收到「这几个单号是什么快递」的指令,仅调用 list_shipping_express 并把原始响应交给后续 skill

适合人员

  • 负责酷特 kutetailor 海外订单履约、手里只有运单号却要对接轨迹或承运商系统的运营
  • 在 Agent 里按 doc 聚合 platform-shipping-query、需要接入 list_shipping_express 原子接口的集成开发
  • 处理海外客诉时系统未录入快递公司、需根据运单号先反查承运商再建跟进单的客服主管
  • 对接正式环境 POST /shipping/listShippingExpress、需规范 params 与 Bearer 登录态的企业内部工具维护者