酷特海外物流运单识别快递公司
将以下提示词粘贴到你的 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 登录态的企业内部工具维护者