Agent Skills
返回列表
酷特海外平台物流单号查询

酷特海外平台物流单号查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,客服、履约或运营同学经常只有一条物流单号,需要确认当前物流节点、承运信息或接口侧返回的原始状态。若每次让 Agent 手写 URL、拼 Query、处理 Bearer 登录态,容易出错,也会和正式环境地址不一致。

本技能是酷特海外运营平台上的最小颗粒度原子接口:只负责 shipping_by_code 这一动作——用物流单号拉取单条物流信息,并把接口真实响应交给上层编排。

技能如何工作

  • 固定走正式环境:GET https://www.kutetailor.com/api/shipping/shipping/getShippingOne,不接受用户输入覆盖 base_url。
  • 调用参数统一放在嵌套对象 params 中:Query 写入 params.query(本接口需传 code);需登录时在 params.accessToken 中传 token,生成 Authorization: Bearer …(若已含 Bearer 则不重复拼接)。
  • 返回以接口响应为准:不补造库存、价格、订单号、优惠或物流状态;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递。

适用边界与注意点

  • 若用户需求涉及多步(查单、改址、批量对账等),本技能只完成本接口;完整链路需由上层 Agent 按聚合 skill(如 platform-shipping-query)或计划文档组合多个原子 skill。
  • 仍为查询类接口,需遵守当前登录态、租户与用户权限;Path/Body/额外 Header 分别走 params.path、params.body、params.headers,与网关约定冲突时以网关为准。

使用场景

  • 客诉工单里只有物流单号,需在酷特正式环境拉取该单号的接口原始物流信息再回复用户。
  • 履约跟进海外订单时,用客户或仓库提供的 `code` 核对平台侧单条运单记录是否与预期一致。
  • 编排 `platform-shipping-query` 链路时,先调用本原子接口拿到 RS 再交给后续改址或对账 skill。
  • 内部 Bot 收到「查这个单号物流」的指令,需按规范传 `params.query.code` 与登录 token 完成一次 GET 查询。

适合人员

  • 处理酷特海外订单客诉、需凭物流单号回查平台运单详情的客服或售后专员
  • 在 kutetailor 海外运营后台跟进发货、要用单号对齐承运与节点信息的履约协调人员
  • 把 `shipping_by_code` 编入多步 Agent 计划、需固定正式环境地址与 params 规范的后端或集成工程师
  • 做物流状态核对或对账前、只需单条 `getShippingOne` 结果而非整表导出的运营分析同事