海外运营平台运单号物流查询
将以下提示词粘贴到你的 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,不要自行改写或忽略。
使用场景
- 客服在处理售后咨询时,需根据用户提供的运单号查询物流单详情,告知最新派送状态。
- 运营人员在核对跨境订单时,需逐一输入运单号查询物流单详情,确认包裹是否已签收。
- 下游履约系统在自动更新订单状态时,需根据运单号调用该接口拉取物流单详情并刷新记录。
- 数据分析人员在复盘物流时效时,需按运单号批量查询物流单详情,提取关键时间节点。
适合人员
- 海外运营平台的客服代表,需要快速响应客户关于物流进度的咨询。
- 跨境电商的运营专员,需要定期核对订单物流状态并更新发货台账。
- 企业内部系统的集成工程师,需要将运单查询能力嵌入自动化流程。
- 物流数据分析师,需要按运单号提取物流单详情用于时效分析。