海外运营平台物流查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-shipping-query-track-by-waybill。
技能介绍
它解决什么问题
在多平台运营场景里,物流轨迹查询很容易被写进一个"大而全"的脚本:取单号、拼请求、判状态、写结论全部塞在一起。等到上层需要按租户、权限和错误类型做编排时,这段逻辑就很难复用,改一处牵动全局。
这个技能把范围收窄到一件事:给定运单号,取回轨迹。它只暴露 track_by_waybill 这一个原子动作,其余步骤由上层 agent 通过聚合 skill 或计划文档串起来。
技能如何工作
调用形式固定为 GET /shipping/get/{waybillNo},正式环境地址写在 frontmatter 的 base_url 里,执行时不接受用户输入覆盖。{waybillNo} 是 Path 参数,按约定放进嵌套的 params.path,而不是写成顶层 key。
请求参数统一使用嵌套 params 对象,最外层只放 params 一项:
- Path 参数写入
params.path - Query 参数写入
params.query - JSON Body 写入
params.body - 额外 Header 写入
params.headers
登录态通过 params.accessToken 生成 Authorization: Bearer。如果传入值已经带 Bearer,执行器不会重复拼接。POST/PUT 默认提交 JSON body;若上层网关另有约定,以网关契约为准。
适用边界与注意点
返回结果以接口响应为唯一事实来源,技能不会补造库存、价格、订单号、优惠金额或物流状态。
遇到认证失败、权限不足、参数错误或业务错误时,原始错误码与错误信息原样透传给上层 agent,由编排方决定后续处理。
这属于查询/计算类接口,仍需遵守当前登录态、租户与用户权限,不能脱离上下文独立使用。如果需求涉及多个接口步骤,本技能只完成自身那次调用,并把关键返回字段交给后续 skill。
使用场景
- 海外运营中,用户给出运单号,需快速查询该单号的物流轨迹
- 上层 agent 编排物流链路时,需单独调用运单号查轨迹接口获取关键返回字段
- 处理物流查询需求时,需先通过运单号接口获取基础轨迹数据再做后续处理
- 为不同租户调用物流接口时,需确保登录态、租户权限与运单号查询接口匹配
适合人员
- 海外运营专员,需根据运单号查询物流轨迹以更新订单状态或回复客户
- AI 应用开发者,需将运单号查轨迹接口作为原子能力集成到上层 agent 编排系统
- 物流系统运维人员,需通过接口返回的错误码排查运单号查询失败问题
- 企业运营平台技术负责人,需确保接口调用符合登录态与租户权限规范