酷特海外运单物流轨迹查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的说明,在你的 AI 助手中安装 @kutesmart/kutesmart-platform-shipping-query-track-by-waybill。
技能介绍
要解决什么问题
在酷特(Kutesmart)海外运营平台里,客服、履约或运营 Agent 经常只需要一件事:用户给出运单号,立刻拿到该单的物流轨迹(接口返回为列表结构),而不是自己拼 URL、记环境地址或猜字段含义。
本技能是最小颗粒度的原子接口 skill,只负责 track_by_waybill 这一动作。若业务需要查单、改址、多承运商串联等,应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill;本 skill 只完成本接口调用并把关键返回交给后续步骤。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url,对应动作为GET /shipping/get/{waybillNo},完整路径为GET https://www.kutetailor.com/api/shipping/shipping/get/{waybillNo};不接受用户输入覆盖 base_url。 - 参数约定:tool arguments 最外层仅放嵌套
params;Path 变量waybillNo写入params.path;需登录时在params.accessToken生成Authorization: Bearer(值已含Bearer则不再重复拼接)。 - 返回事实:轨迹内容必须以接口响应为准,不要补造库存、价格、订单号、优惠金额或物流状态。
适用边界与注意点
- 触发场景:用户明确要根据运单号查轨迹时使用;多步骤需求本 skill 只承担查询轨迹这一步。
- 认证、权限、参数或业务错误时,应将原始错误码与错误信息透传给上层 Agent,由上层决定重试、换 token 或改流程。
- 归属聚合 skill
platform-shipping-query;与文档doc/skill/platform-shipping-query/SKILL.md中的原始 actiontrack_by_waybill一致。
使用场景
- 海外客服接到客户报出的运单号,需在酷特正式环境拉取该单物流轨迹列表,再据此说明当前节点与历史扫描。
- 履约或异常件排查时,运营人员只有 waybillNo,要按固定 GET 接口核对平台记录的轨迹是否与客诉描述一致。
- 上层 Agent 编排多单处理流程,到「查轨迹」一步只调用 track_by_waybill,把接口返回列表交给后续 skill 做判责或通知。
- 集成 kutetailor 的自动化工单在触发后传入 params.path.waybillNo,由技能完成单次查询并透传原始错误码给编排层。
适合人员
- 对接酷特 kutetailor 正式环境、要在 Agent 工具链里嵌入「按运单号查轨迹」原子接口的后端或集成工程师
- 日常处理海外订单物流咨询、用户只提供运单号且回复必须对齐平台轨迹数据的客服或履约专员
- 负责 platform-shipping-query 聚合方案、需把 track_by_waybill 与查单等步骤拆开编排的 Agent 产品或实施同学
- 在客诉或 SLA 复盘流程中,需用运单号快速调取酷特平台扫描时间线供内部分析的运营质检人员