酷特海外运营 · 快递100路由查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-shipping-query-waybill-route。
技能介绍
要解决什么问题
海外订单履约里,客服、运营或自动化 agent 往往只需要当前运单在快递100侧的路由轨迹,而不是自己去拼网关地址、鉴权头和 query 参数。若把「查路由」和下单、改址、对账混在一个大工具里,失败时也很难把原始错误码准确回传给上层编排。
本技能对应酷特海外运营平台(kutetailor.com)上的原子动作 waybill_route:用固定正式环境 GET /api/shipping/shipping/express/waybill,按运单号与快递公司编码拉取快递100路由,结果以接口响应为准。
技能如何工作
- 触发:用户或上层 agent 需要查询快递100路由;多步骤业务由上层组合多个原子 skill,本技能只完成本接口。
- 参数约定:
tool arguments最外层仅使用嵌套params;Path →params.path,Query(如waybillNo、快递公司编码)→params.query,Body →params.body,额外 Header →params.headers。 - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer;若已含Bearer前缀则不再重复拼接。 - 执行:必须使用 frontmatter 中的固定
base_url,不得用用户输入覆盖;GET 查询参数挂在 URL query;将接口返回交给后续 skill 或展示层。
边界与注意点
这是查询类接口,仍需满足当前租户与用户权限;不得根据想象补造物流状态、订单号或节点时间。若返回认证、权限、参数或业务错误,应把原始错误码与错误信息传给上层 agent,由编排层决定重试、换单或人工介入。
使用场景
- 客服处理海外订单咨询时,需用平台内运单号与快递公司编码拉取快递100路由节点并回复客户
- 上层 agent 编排 platform-shipping-query 链路时,单独调用本技能完成 waybill_route 再交给后续对账或通知步骤
- 运营核对某票海外件是否已揽收/在途,通过正式环境 GET waybill 接口查看轨迹而非手工查第三方页面
- 发货回调或工单触发后,自动化流程按 waybillNo 查询路由,用于更新内部履约状态展示
适合人员
- 负责酷特海外运营平台订单履约、需在系统内查轨迹而非外站复制的运营专员
- 正在把 platform-shipping-query 拆成原子 skill 并对接 kutetailor 鉴权与 params 约定的 agent 集成工程师
- 处理海外客诉、要用运单号核对快递100节点是否与客户描述一致的客服主管
- 搭建跨境发货后状态同步流水线、只需「查路由」这一 HTTP 动作的后端开发