酷特海外物流单详情
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-shipping-detail。
技能介绍
要解决什么问题
在海外运营或客服场景里,你往往只需要某一张物流单的完整详情,而不是整条「查列表 → 再点进详情」的编排。若 agent 直接拼 HTTP,还要记住正式环境域名、Authorization: Bearer 与 path 参数 id 的约定,也容易和同一平台其它 shipping 接口混在一起。
本 skill 把动作收敛为单一接口:按物流单 id 拉取详情,返回以接口为准的 ShippingDetailVO,供上层继续对账、回复客户或串联其它原子 skill。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的正式环境
base_url(GET …/api/shipping/shipping/{id}),不接受用户输入覆盖域名。 - 参数形态:tool arguments 最外层只有
params;path 写在params.path(含id),登录态用params.accessToken生成Authorization: Bearer(值里已有Bearer则不重复拼接)。 - 动作映射:
shipping_detail→GET /shipping/{id},URL 中的{id}从params.path替换。 - 结果处理:以响应体为事实来源;若返回认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent,而不是本地「补全」物流状态或单号。
适用边界
这是 platform-shipping-query 聚合链路里的最小粒度 skill,只负责 shipping_detail。用户若要列表、轨迹或多步流程,应由上层 agent 按聚合 skill 或计划文档编排多个原子接口;本 skill 只完成本步调用并把关键字段交给后续步骤。
使用场景
- 客服收到海外买家咨询某票货,需在酷特海外运营平台按物流单 id 核对 ShippingDetailVO 再回复
- 对账时发现某笔发货记录异常,agent 需调用 shipping_detail 拉取该 id 的原始详情字段供人工比对
- 编排 platform-shipping-query 链路时,在列表或筛选之后只需单票详情,由本 skill 完成 GET /shipping/{id}
- 跨境运营周报要引用指定物流单的状态与明细,上层 agent 传入 accessToken 与 path.id 触发查询
适合人员
- 对接酷特 kutetailor 正式环境的集成工程师,需要在 agent 里封装单票物流详情接口
- 海外运营客服主管,希望对话 agent 能按单号 id 查详情而不是让员工登录后台逐条点查
- 编写 platform-shipping-query 聚合 skill 的维护者,要把 shipping_detail 作为可编排的原子动作接入计划文档
- 负责跨境发货异常排查的业务运营,需把认证错误与业务错误码原样交给上层做分流处理