Agent Skills
返回列表
酷特海外发货快递不可达校验

酷特海外发货快递不可达校验

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-check-unreach。

技能介绍

要解决什么问题

海外发货前,承运商或线路是否不可达会直接影响能否下单、选快递和后续履约。若把「查不可达」和建单、改地址、打单等步骤混在一个大工具里,Agent 很难在失败时只重试单一步骤,也不利于按租户权限做最小调用。

本技能是酷特海外运营平台发货域里的原子接口 skill,只负责 check_unreach:向正式环境固定地址发起一次 GET,用 Query(如 express 等)校验快递不可达,并把接口原样返回交给上层编排。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的 base_url,对应路径 /shipping/checkUnreachShipping,不接受用户输入覆盖正式环境地址。
  • 参数约定:tool 参数统一放在嵌套 params 下;Query 写入 params.query;需登录时在 params.accessToken 生成 Authorization: Bearer(已含 Bearer 则不重复拼接)。
  • 返回事实:以接口响应为准,不补造库存、价格、订单号或物流状态;认证、权限、参数或业务错误时,将原始错误码与信息回传上层 Agent。

适用边界与注意点

  • 仅覆盖校验快递不可达这一动作;完整发货链路需配合聚合 skill platform-shipping-manage 或其它原子 skill 按文档编排。
  • 属于查询/计算类接口,仍受当前登录态、租户与用户权限约束。
  • 若用户需求包含多步接口,本 skill 只完成本步,关键字段由后续 skill 继续处理。

使用场景

  • 在酷特海外运营平台创建或修改发货单前,用 Query 参数(如 express)调用接口,确认承运线路对目的地是否不可达。
  • 编排 platform-shipping-manage 等多步发货流程时,单独执行 check_unreach,将接口 RS 原样交给后续建单或改址 skill。
  • 客服收到「某快递能否派送」咨询时,按用户给出的 express 等信息发起 GET 校验,依据返回决定是否建议换快递或调整地址。
  • 上层 Agent 识别用户仅需「校验不可达」一步时,固定走正式环境 checkUnreachShipping,避免与建单、打单等接口混在同一工具里。

适合人员

  • 负责酷特海外店铺发货与承运商配置、选快递前必须核实线路是否不可达的运营或履约同学
  • 维护 platform-shipping-manage 或同类编排文档、要把 check_unreach 作为独立 HTTP 步骤接入的 Agent 集成开发者
  • 处理跨境订单派送异常、需用平台正式返回(含错误码)向客户解释不可达原因的客服或售后专员
  • 为企业内部发货助手编写 tool schema、需遵守嵌套 params 与 Bearer accessToken 约定的后端或自动化工程师