Agent Skills
返回列表
酷特海外物流单详情

酷特海外物流单详情

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 作为可编排的原子动作接入计划文档
  • 负责跨境发货异常排查的业务运营,需把认证错误与业务错误码原样交给上层做分流处理