Agent Skills
返回列表
KuteSmart 订单状态公共查询

KuteSmart 订单状态公共查询

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-query-public-order-status。

技能介绍

解决的问题

在 KuteSmart 海外运营平台中,调用方常需要“这个订单现在处于什么状态”这样一句回答。难点在于订单状态入口分散、鉴权与租户上下文容易遗漏,而且很多系统会在缺少状态时用库存、价格或物流字段猜测补全。本 skill 只提供最小颗粒度的 public_order_status 动作,目标是让上层 agent 获得一个可信的查询接口,而不是替它完成完整业务流程。

如何工作

核心能力只有一个:向固定正式环境地址发起 GET 请求:
https://www.kutetailor.com/api/order/api/public/order/status/{orderid}。
调用参数统一放入嵌套的 params 对象,Path 参数写入 params.path.orderid,不要使用 params.xxx 这种顶层点号 key。正式环境地址来自 frontmatter 的 base_url,执行器必须固定使用它,不能被用户输入覆盖。

关键步骤:

  • 上层 agent 准备好订单号,并确认当前登录态、租户和用户权限仍然适用。
  • 构造 GET 请求,把 {orderid} 替换为 params.path.orderid 的实际值。
  • 如有登录态,通过 params.accessToken 生成 Authorization: Bearer;如果传入值已经包含 Bearer,不要重复拼接。
  • 将接口原始 String 返回作为事实来源,交给后续 skill 或业务链路处理。

适用边界

这个 skill 只负责公共 API 查询订单状态,不负责下单、改单、取消、库存、价格、优惠或物流轨迹。返回字段以接口响应为准,不要补造订单号、金额、库存或物流状态。如果接口返回认证、权限、参数或业务错误,应原样把错误码和错误信息传给上层 agent。需要多步骤聚合时,应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill,本 skill 只完成自己这一个接口动作。

使用场景

  • 客服在回复客户关于订单发货进度的咨询时,需要输入订单号调用接口获取当前准确的订单状态。
  • 运营人员在排查异常订单时,需要通过订单号直接查询该订单在平台上的最新状态,确认是否卡在某个环节。
  • 上层Agent在编排多步骤业务流程时,需要作为一环调用此接口获取订单当前状态,以便决定后续的流转逻辑。

适合人员

  • 电商平台客服专员,日常需要快速响应客户关于订单发货或签收状态的咨询。
  • 海外业务运营人员,在排查异常订单时需要准确获取单笔订单的最新系统状态。
  • AI应用开发者,正在构建基于大模型的订单管理Agent,需要调用原子接口查询订单状态。