海外运营平台订单预提交结果查询
将以下提示词粘贴到你的 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 的后端工程师:需要把单个平台接口封装成最小颗粒度、可编排的原子技能。
- 负责海外运营平台对接的开发者:需要在正式环境验证订单号查询的参数与认证头是否按契约生效。
- 排查线上订单问题的技术支持:需要依据接口返回的原始错误码,区分认证失败、权限不足与业务错误。