酷特海外运营运单物流查询

要解决什么问题

海外运营、客服或履约侧经常需要按运单号核对物流单详情，而不是在多个系统里手工翻查。本技能对应酷特海外运营平台的一个最小粒度接口动作：shipping_by_waybill，只负责「根据运单号拉取物流单详情」，多步业务（例如先查订单再查物流）应由上层 Agent 按聚合 skill 或计划文档串联多个原子 skill。

技能如何工作

• 固定端点：执行器使用 frontmatter 中的正式环境 base_url，调用 GET /shipping/getShippingByWaybillNo，不接受用户输入覆盖域名或环境。
• 参数约定：tool 参数统一放在嵌套对象 params 下；运单号通过 params.query.waybillNo 传入。需登录态时，用 params.accessToken 生成 Authorization: Bearer（值已含 Bearer 则不再拼接）。
• 返回事实：以接口响应为准，返回 ShippingDetailVO 相关字段；认证、权限、参数或业务错误时，应把原始错误码与错误信息交给上层 Agent，不要自行补造库存、价格、订单号或物流状态。

适用边界与注意点

本技能仅完成单次查询，不替代完整物流链路编排。查询类接口仍受当前登录态、租户与用户权限约束；若网关对 POST/PUT 或 Header 有额外约定，以平台网关契约为准。聚合能力见 platform-shipping-query 文档中的同类 action 编排说明。