Agent Skills
返回列表
酷特海外运营平台订单详情查询

酷特海外运营平台订单详情查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在酷特海外运营(kutetailor.com)场景里,Agent 或上层编排经常需要按订单 ID 拉取一份可信的订单详情,而不是根据对话内容猜测金额、物流或状态。本技能是最小颗粒度的原子接口技能,只覆盖平台动作 public_order_details:用公共 API 查询单笔订单详情。若用户诉求需要登录、列表、改状态等多步流程,应由上层 Agent 按聚合 skill 或计划文档串联多个原子 skill;本技能只完成这一次 GET 调用,并把关键返回字段交给后续步骤。

技能如何工作

  • 固定环境:执行器必须使用 frontmatter 中的正式环境 base_url(GET https://www.kutetailor.com/api/order/api/public/order/details/{orderid}),不接受用户输入覆盖地址。
  • 参数约定:tool arguments 最外层只放嵌套对象 params;Path 参数写在 params.path(此处为 orderid),Query 写在 params.query,Body 写在 params.body,额外 Header 写在 params.headers。
  • 请求形态:public_order_details 为 GET,路径变量 {orderid} 从 params.path 替换后发起请求。
  • 结果原则:返回内容以接口响应为唯一事实来源;不得补造库存、价格、订单号、优惠金额或物流状态。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息透传给上层 Agent。

适用边界与注意点

本接口属于查询类公共 API,但仍可能受当前登录态、租户与用户权限约束;需要 Bearer 的场景通过 params.accessToken 生成 Authorization: Bearer …(若已含 Bearer 前缀则勿重复拼接)。聚合能力见 platform-order-query;本技能对应原始 action 为 public_order_details。

使用场景

  • 客服收到买家提供的订单号,需在酷特海外运营平台核对金额、商品行与当前订单状态再回复。
  • 跨境运营 Agent 在编排链路中拿到 `orderid`,需调用固定 GET 接口拉取单笔订单详情作为后续判断依据。
  • 对账或异常排查时,业务人员要根据系统里的订单 ID 查询公共 API 返回的原始详情字段,避免手工臆测数据。
  • 上层聚合 skill `platform-order-query` 拆步执行时,本步仅负责 `public_order_details` 并向下游传递关键响应。

适合人员

  • 处理酷特海外定制/电商订单的客服,需要按客户发来的订单号核对平台侧详情再沟通改单或退款。
  • 搭建企业运营 Agent 的集成工程师,要把 `public_order_details` 作为原子 tool 接入多接口编排而非一次塞满全流程。
  • 负责 kutetailor 订单对账的运营或财务,需用订单 ID 拉取接口事实数据与内部单据比对。
  • 维护 `platform-order-query` 聚合 skill 的产品或平台同学,需要明确本原子动作的职责边界与错误透传约定。