海外运营订单发货条件检查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-cancel-confirm-check-shipping-condition。
技能介绍
要解决什么问题
在海外运营平台的订单撤单确认链路里,业务方往往要先判断一批订单当前是否仍满足发货条件,再决定能否继续撤单或走后续节点。若由 Agent 自行臆测库存、物流或订单状态,容易与平台真实数据不一致,引发误操作。
本技能是最小颗粒度的原子接口封装,只负责调用平台 check_shipping_condition 动作,把接口返回作为事实依据交给上层编排。
技能如何工作
- 固定环境:使用 frontmatter 中的正式环境
base_url(GET/order/orden/checkShippingCondition),调用时不得用用户输入覆盖地址。 - 参数形态:tool arguments 最外层仅包含嵌套对象
params;查询条件通过params.query传入,其中orderIds为必填 Query 字段。 - 鉴权:需登录态时,用
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 返回处理:以接口 RS 响应为准,不补造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,将原始错误码与错误信息向上传递。
适用边界与注意点
- 仅完成单次查询/计算类接口调用;若用户需要撤单确认全链路,应由上层 Agent 按聚合 skill
platform-order-cancel-confirm或计划文档组合多个原子 skill。 - 仍受当前租户、用户权限约束;多订单场景注意
orderIds的格式是否符合网关约定。 - 与聚合文档中的原始 action 对应关系:
check_shipping_condition→ 本技能唯一职责。
使用场景
- 撤单确认前,需用一批 orderIds 调用平台接口核对是否仍满足发货条件
- 上层 Agent 编排撤单确认链路时,在本步骤只执行 checkShippingCondition 并传递 RS 结果
- 客服处理海外订单撤单申请时,先查询指定订单能否继续走发货流程再给出结论
- 多订单批量撤单审核中,按网关要求传入 orderIds 做发货条件批量检查
适合人员
- 在海外运营平台处理撤单确认、需以接口结果判断能否继续操作的运营专员
- 正在实现 platform-order-cancel-confirm 聚合 skill、需接入 check_shipping_condition 的 Agent 集成工程师
- 对接酷特 kutetailor 正式环境、要固定 base_url 与 Bearer 鉴权规范的内部系统集成开发
- 负责订单履约与撤单风控、要求返回字段不臆造、错误码需原样上报的流程负责人