Agent Skills
返回列表
酷特海外发货托管信息查询

酷特海外发货托管信息查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台做发货管理时,业务侧经常需要确认托管信息(平台侧 auto_delivery 数据),再决定是否走自动发货、补全物流上下文或交给下游接口。若 Agent 直接拼 URL、混用 query/path 或擅自改正式环境地址,容易触发权限错误,也会在失败时「补造」订单或物流状态。

本技能是最小颗粒度的原子接口 skill,只负责一次 GET /shipping-auto-delivery(action:auto_delivery),把接口原样返回交给上层编排。

技能如何工作

  • 固定正式环境:请求必须走 frontmatter 中的 base_url(https://www.kutetailor.com/api/shipping/shipping-auto-delivery),不接受用户输入覆盖。
  • 统一参数结构:tool arguments 最外层仅含 params;Path → params.path,Query → params.query,Body → params.body,额外 Header → params.headers。
  • 登录态:需登录的调用通过 params.accessToken 生成 Authorization: Bearer …;若 token 已含 Bearer 前缀则不再重复拼接。
  • 返回以接口为准:成功时解析为 AutoDeliveryVO 相关字段;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,由聚合 skill 或计划文档决定下一步。

适用边界与注意点

  • 本 skill 不包含创建订单、改库存、改价等多步链路;完整业务流程需组合 platform-shipping-manage 等聚合 skill。
  • 属于查询类接口,仍受当前租户、用户权限约束;无参数或依赖会话上下文时,以平台网关实际契约为准。
  • 编排时请记住:最外层不要用 params.xxx 这类点号顶层 key。

使用场景

  • Agent 编排「先查托管再发货」链路时,调用本 skill 获取 `auto_delivery` 返回的托管字段
  • 海外运营在对话里确认某订单是否已具备平台侧自动发货托管数据,再决定是否走下一接口
  • 集成 `platform-shipping-manage` 聚合 skill 时,将本接口作为唯一原子步骤完成 GET `/shipping-auto-delivery`
  • 履约脚本在触发自动发货动作前,用正式环境固定地址拉取 AutoDeliveryVO,避免手写 URL

适合人员

  • 对接酷特 kutetailor 正式环境的集成工程师,要把查询托管信息封装成 Agent 可调用的原子 tool
  • 维护海外运营发货聚合 skill 的后端开发,需要在多接口计划里插入 `auto_delivery` 单步
  • 海外仓/跨境履约运营,需核对订单在平台侧的托管发货状态而非自行猜测物流节点
  • 负责物流中台对话助手的实施同学,要求错误时透传原始错误码而不是补造订单或库存