Agent Skills
返回列表
酷特海外发货合并托管校验

酷特海外发货合并托管校验

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

海外运营发货流程里,同一批或关联订单是否应合并托管,往往取决于平台侧规则与当前单据状态。人工在后台逐单核对成本高,Agent 编排「创建发货 → 校验 → 后续动作」时,也需要在固定节点拿到接口真实结论,而不是猜测库存、物流或优惠结果。

本技能是最小颗粒度的原子接口 skill,只负责 check_merge 这一动作:向酷特正式环境提交发货相关数据,由平台返回是否合并托管的判定。

技能如何工作

  • 固定端点:使用 frontmatter 中的正式环境地址 POST …/shipping/checkMerge,调用时不得用用户输入覆盖 base_url。
  • 参数结构:tool arguments 最外层仅包含嵌套的 params;登录态通过 params.accessToken 生成 Authorization: Bearer(已含 Bearer 则不再拼接);JSON Body 写入 params.body,格式为 application/json,对应接口要求的 SaveShippingVO。
  • 返回处理:以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 Agent,由聚合 skill 或计划文档继续编排其它原子 skill。

适用边界与注意点

  • 仅完成「校验是否合并托管」单步;多接口完整链路需由上层按 platform-shipping-manage 等聚合能力组合多个原子 skill。
  • 属于查询/计算类接口,仍受当前登录态、租户与用户权限约束;不要在本 skill 层补造订单号、价格或物流状态等字段。

使用场景

  • Agent 在保存或提交发货单之后、执行后续出库或合单动作之前,需要调用平台接口确认是否应合并托管。
  • 对接 kutetailor 正式环境时,向 `POST /shipping/checkMerge` 提交 `SaveShippingVO`,以接口返回 RS 作为是否合并托管的依据。
  • 上层按 `platform-shipping-manage` 编排多步发货链路,本 skill 只负责 `check_merge` 一步并把关键字段交给后续原子 skill。
  • 海外运营处理关联订单或同一批次发货时,用校验接口替代在后台逐单人工核对合并托管规则。

适合人员

  • 对接酷特海外运营平台发货域 API、需在链路中固定插入合并托管校验节点的集成工程师
  • 编写 platform-shipping-manage 等聚合编排、需要可复用 `check_merge` 原子能力的 Agent 或技能方案设计者
  • 负责跨境/海外发货流程自动化、要在提交前拿到平台侧合并托管判定的运营或流程负责人
  • 维护 SaveShippingVO 与 shipping 接口、需排查合并托管相关认证或业务错误的后端开发