酷特海外运营 · 快递100路由查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-waybill-route。
技能介绍
要解决什么问题
海外订单履约里,客服、运营和仓库经常要在酷特海外运营平台里核对运单在快递100侧的路由轨迹,而不是只看平台里一条静态状态。若由 Agent 临时拼 URL、猜 query 字段或改正式环境域名,容易打到错误网关,或在接口报错时「补全」物流节点。
本技能是 platform-shipping-query 聚合链路中的原子接口,只负责 waybill_route 这一动作:向固定正式环境发起查询,并把接口原样返回交给上层编排。
技能如何工作
- 固定端点:执行器使用 frontmatter 中的
base_url(正式环境GET …/shipping/express/waybill),不接受用户输入覆盖域名。 - 参数约定:tool 参数统一放在嵌套
params下;运单号、快递公司编码等走params.query;需登录时在params.accessToken生成Authorization: Bearer(已含Bearer则不重复拼接)。 - 返回原则:路由、节点时间等以 RS 响应为准;认证、权限、参数或业务错误时,把原始错误码与错误信息回传,便于上层 Agent 重试、换 skill 或提示用户。
适用边界
- 仅覆盖 查询快递100路由;创建运单、改址、批量对账等需组合其它原子 skill 或聚合 skill 文档中的步骤。
- 多租户与权限仍由平台侧校验;本 skill 不替代登录与授权流程。
- 用户一次需求若包含多接口步骤,本 skill 只完成本接口调用,关键字段由后续 skill 继续处理。
使用场景
- 客户在酷特海外订单里追问包裹到哪一站,需用运单号调正式环境接口拉快递100路由节点
- 履约异常排查:运营拿到 waybillNo 与快递公司编码,核对平台侧路由是否与承运商轨迹一致
- 上层 Agent 编排 platform-shipping-query 时,本步只查 waybill_route,把 RS 交给后续改址或对账 skill
- 仓库出库后客服要在对话里展示轨迹,需按 query 参数查询而非口述或猜测物流状态
适合人员
- 处理酷特/kutetailor 海外订单客诉、需按运单号查快递100轨迹的客服
- 在海外运营平台做发运跟进、经常核对 waybill 路由是否更新的履约或物流协调
- 编写多步 shipping 编排的 Agent 维护者,需要 waybill_route 原子 skill 对接固定 GET 端点
- 对接酷特 shipping API 的集成工程师,要把查询类接口参数统一放进 params.query 与 accessToken