酷特海外平台订单状态查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-query-public-order-status。
技能介绍
要解决什么问题
在对接酷特(Kutesmart)海外运营平台时,业务侧或上层 Agent 往往只需要确认某一订单当前状态,而不必自己拼 URL、记 Path 参数或处理 Bearer 登录态。若把「查状态」和下单、改址、物流等步骤混在一个大工具里,编排和排错都会变重。本 skill 是最小颗粒度的原子接口 skill,只负责 public_order_status 这一动作。
技能如何工作
正式环境固定为 GET https://www.kutetailor.com/api/order/api/public/order/status/{orderid}。执行器从 frontmatter 读取 base_url,不接受用户输入覆盖正式地址。
调用约定与其它 Kutetailor 原子 skill 一致:tool arguments 最外层只放 params 对象。Path 参数(本接口为 orderid)写在 params.path;若需登录态,用 params.accessToken 生成 Authorization: Bearer(值里已有 Bearer 则不再重复拼接)。Query、Body、额外 Header 分别对应 params.query、params.body、params.headers。
接口返回以平台响应为准:应把关键状态字段交给后续 skill 或聚合编排;不要根据猜测补造库存、价格、订单号、优惠或物流状态。若返回认证、权限、参数或业务错误,应把原始错误码与错误信息原样传给上层 Agent。
适用边界
- 仅覆盖「公共 API 查询订单状态」;完整订单链路需配合
platform-order-query等聚合 skill 或其它原子 skill 按文档编排。 - 仍是查询类接口,需遵守当前租户、用户与登录态权限;无权限时以接口错误为准,不在 skill 内做业务兜底。
使用场景
- 客服或售后 Agent 收到用户提供的订单号,需向酷特正式环境公共 API 查询该 orderid 的当前状态后再回复或升级工单。
- 多步订单自动化流程在改址、取消或催产前,先调用 public_order_status 读取平台状态,再决定是否执行后续原子 skill。
- 海外定制业务运营在内部 CRM/工单中触发流程,按 Path 参数 orderid 拉取 kutetailor 订单状态并回写展示字段。
- 编排 platform-order-query 相关链路时,将本 skill 作为独立 GET 节点,与下单、物流等其它接口 skill 按文档串联。
适合人员
- 对接酷特 kutetailor 海外运营平台的后端工程师,需要在 Agent 工具链中挂载「仅查订单状态」的单接口 skill。
- 处理海外定制订单客诉与跟单的运营/客服主管,需按 orderid 核对平台侧真实状态字段,避免凭印象答复用户。
- 设计企业订单自动化编排的解决方案或 Agent 架构师,要把状态查询从聚合 skill 拆成可复用、可测试的原子步骤。
- 维护 B2B 订单中台或 ERP 集成的开发同学,在编排里插入 GET 状态调用并把认证、权限类原始错误透传上层。