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

海外运营平台运单号物流查询

企业运营 更新于 2026.08.29

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

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

技能介绍

这个技能解决什么问题

海外运营平台侧,客服、运营和下游系统经常需要按运单号查询物流单详情。人工在后台复制粘贴、跨系统拼接字段既慢又容易出错;让 Agent 直接调用平台接口时,还要处理鉴权、参数位置和错误透传。这个技能把「按运单号查询物流单详情」收敛成一个最小颗粒度接口动作,避免 Agent 在业务流程里临时拼请求。

技能如何工作

  • 触发场景:用户需要根据运单号查询物流单详情时使用。本技能只负责一个原子接口动作 shipping_by_waybill。
  • 接口动作:GET /shipping/getShippingByWaybillNo,Query 参数为 waybillNo;正式环境固定调用 https://www.kutetailor.com/api/shipping/shipping/getShippingByWaybillNo。
  • 返回结果:接口返回 ShippingDetailVO。执行器以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态。
  • 参数结构:tool arguments 统一使用嵌套 params 对象。最外层只放 params,不要写成 params.xxx 这类点号顶层 key。Path 参数写入 params.path,Query 参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。
  • 鉴权方式:登录态接口使用 params.accessToken 生成 Authorization: Bearer;如果传入值已含 Bearer,不要重复拼接。
  • 执行约束:正式环境地址固定在 frontmatter 的 base_url,调用时不从用户输入覆盖。POST/PUT 默认发送 JSON body;如果上层接口网关另有约定,以网关契约为准。

适用边界与注意点

  • 这是最小颗粒度接口 skill,只完成本接口调用。用户需求需要多个接口步骤时,由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill,并把关键返回字段交给后续 skill。
  • 执行器必须使用 frontmatter 中的固定正式环境地址,不接受用户输入覆盖 base_url。
  • 这是查询或计算类接口,仍需遵守当前登录态、租户和用户权限。
  • 接口返回认证、权限、参数或业务错误时,把原始错误码和错误信息传给上层 Agent,不要自行改写或忽略。

使用场景

  • 客服在处理售后咨询时,需根据用户提供的运单号查询物流单详情,告知最新派送状态。
  • 运营人员在核对跨境订单时,需逐一输入运单号查询物流单详情,确认包裹是否已签收。
  • 下游履约系统在自动更新订单状态时,需根据运单号调用该接口拉取物流单详情并刷新记录。
  • 数据分析人员在复盘物流时效时,需按运单号批量查询物流单详情,提取关键时间节点。

适合人员

  • 海外运营平台的客服代表,需要快速响应客户关于物流进度的咨询。
  • 跨境电商的运营专员,需要定期核对订单物流状态并更新发货台账。
  • 企业内部系统的集成工程师,需要将运单查询能力嵌入自动化流程。
  • 物流数据分析师,需要按运单号提取物流单详情用于时效分析。