Agent Skills
返回列表
海外运营平台订单预提交结果查询

海外运营平台订单预提交结果查询

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-progress-pre-submit-result。

技能介绍

它解决什么问题

在海外运营平台(KuteSmart)里,订单的预提交结果是一个独立接口的返回物。上层 agent 真正头疼的不是「怎么发一个 HTTP 请求」,而是三件事:该打哪个 URL、参数和登录态怎么塞进 tool arguments、以及返回的 RS 里哪些字段可以继续往下传。本 skill 把这一个接口动作固化下来,调用方只需要给出订单号,剩下的路由、认证头、错误透传都按契约执行。

它怎么工作

核心动作只有一个:pre_submit_result。

  • 固定端点:正式环境地址写在 frontmatter 的 base_url 中,即 GET https://www.kutetailor.com/api/order/order/orden-pre-submit/selectByOrdenNo,调用时不接受用户输入覆盖。
  • 参数组织:所有 tool arguments 统一放进嵌套的 params 对象,最外层只放 params,不允许 params.xxx 这类点号顶层 key。查询条件写入 params.query,其中 ordenNo 必填,id 可选。
  • 认证:由 params.accessToken 生成 Authorization: Bearer;如果传入值本身已经包含 Bearer,不再重复拼接。
  • 返回处理:以接口响应为事实来源,原样返回 RS。遇到认证、权限、参数或业务错误,把原始错误码和错误信息一并交给上层 agent,不做二次包装或猜测性补全。

适用边界

  • 这是最小颗粒度接口 skill,只完成这一次查询。需要串起完整业务链路时,由上层 agent 按聚合 skill(platform-order-progress)或计划文档编排多个原子 skill。
  • 属于查询或计算类接口,仍受当前登录态、租户和用户权限约束。
  • 接口没有返回的字段(例如库存、价格、优惠金额、物流状态),一律不臆造。

使用场景

  • 客服收到客户订单号,需要查询该订单在正式环境的预提交结果,确认是否已成功提交。
  • 上层 agent 编排订单进度链路时,需要先调用本接口拿到 pre_submit_result,再交给后续原子技能。
  • 集成方进行接口联调,需要按固定 base_url 和 params.query 传入 ordenNo,验证接口返回 RS 是否符合预期。
  • 排查订单异常时,需要获取接口返回的原始错误码与错误信息,判断是认证、权限还是业务层面问题。

适合人员

  • 海外运营平台的运营专员:需要根据订单号查询预提交结果,并据此回复客户提交状态。
  • 构建上层 agent 的后端工程师:需要把单个平台接口封装成最小颗粒度、可编排的原子技能。
  • 负责海外运营平台对接的开发者:需要在正式环境验证订单号查询的参数与认证头是否按契约生效。
  • 排查线上订单问题的技术支持:需要依据接口返回的原始错误码,区分认证失败、权限不足与业务错误。