KuteSmart 订单状态公共查询
将以下提示词粘贴到你的 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,需要调用原子接口查询订单状态。