Agent Skills
返回列表
酷特海外运营发货地址查询

酷特海外运营发货地址查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台里处理物流、对账或客服工单时,经常需要把 发货单号(shippingCode)对应成可读的 发货地址。手工在后台翻页既慢,也容易和 API 返回不一致。本技能只做一件事:在已登录前提下,调用酷特正式环境的固定 GET 接口,把平台返回的地址字段原样交给上层 agent。

技能如何工作

这是 最小颗粒度 的原子 skill,对应聚合能力 platform-shipping-query 中的 shipping_address action。

  • 固定请求:GET https://www.kutetailor.com/api/shipping/shipping-address/getShippingAddress
  • 查询参数:通过 params.query 传入 shippingCode
  • 鉴权:params.accessToken 生成 Authorization: Bearer …(若已含 Bearer 则不重复拼接)
  • 参数结构:最外层仅 params;Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers
  • base_url 不可被用户输入覆盖,执行器以 frontmatter 中的正式环境地址为准

返回必须以接口响应为事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,便于编排其它 skill 继续处理。

适用边界与注意点

  • 仅覆盖「获取发货地址信息」这一步;若用户还需要轨迹、运费、库存等多接口链路,需由上层 agent 按聚合 skill 或计划文档编排多个原子 skill。
  • 仍为 登录态、租户与用户权限 下的查询类接口;无 token 或权限不足时不会「补造」地址或物流状态。
  • 不要臆造库存、价格、订单号、优惠金额等与本接口无关的字段。

使用场景

  • 客服收到客户提供的 shippingCode,需要在酷特海外运营后台核对对应发货地址再回复
  • 对账时要把某笔发货单的 shippingCode 解析成完整收货地址写入内部工单
  • 上层 agent 编排物流链路时,先按 shippingCode 拉取发货地址再交给后续轨迹或运费 skill
  • 运营在处理跨境发货异常时,需用发货单号查询系统登记的发货地址是否与客诉一致

适合人员

  • 海外运营客服:客诉里只有发货单号,需快速查到系统内发货地址再对外说明
  • 跨境物流协调:多单并行时要把 shippingCode 对应地址整理给仓库或承运商
  • 搭建酷特物流查询 agent 的集成工程师:需要原子 skill 只负责 getShippingAddress 一步
  • 企业运营中台维护:在聚合 skill 里编排 shipping_address 与其它 shipping 接口