Agent Skills
返回列表
酷特海外订单明细列表查询

酷特海外订单明细列表查询

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-detail-list。

技能介绍

要解决什么问题

在海外运营场景里,订单往往由多行组成明细(SKU、数量、价格、定制项等)。上层 agent 若要把「查一单」拆成多步接口,需要先拿到订单明细列表,再交给后续 skill 做库存核对、改单或对账。本技能是酷特海外运营平台上的原子接口 skill,只负责 order_detail_list 这一动作:按订单 ID 拉取组成明细,不包办整条业务链路。

技能如何工作

  • 固定环境:执行器使用 frontmatter 中的正式环境 base_url(https://www.kutetailor.com/api),调用路径为 GET /order/orden-detail/getOrdenDetail,不接受用户输入覆盖 base_url。
  • 传参约定:tool arguments 最外层仅包含嵌套对象 params;Query 参数 ordenId 写在 params.query;登录态通过 params.accessToken 生成 Authorization: Bearer(值已含 Bearer 时不重复拼接)。
  • 返回事实:以接口响应为准,不向用户或上层 agent 补造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,应把原始错误码与信息向上传递。

适用边界与注意点

若用户需求涉及登录、订单列表、改价、发货等多步操作,需由上层按聚合 skill platform-order-components 或计划文档编排多个原子 skill;本 skill 只完成本接口调用并把关键返回字段交给后续步骤。查询类接口仍受当前登录态、租户与用户权限约束。

使用场景

  • 客服接到海外客户询单时,已有平台订单号,需按 ordenId 拉取组成明细核对 SKU 与数量
  • 对账前 agent 先调用本接口获取订单行项目,再与 ERP 或仓储回传数据逐行比对
  • 改单或拆单流程中,上层编排先查询当前订单明细列表,再决定后续改价或取消行项接口
  • 运营排查「一单多行」异常时,用固定 GET 接口查看平台侧订单组成,避免手工登录后台翻页

适合人员

  • 对接酷特海外运营 API 的集成工程师,需要在 agent 工具链里封装 ordenId 查询明细
  • 海外 B2B 运营专员,经常要核对定制订单各行物料与平台展示是否一致
  • 构建 platform-order-components 聚合 skill 的 agent 维护者,要插入 order_detail_list 原子步骤
  • 财务或供应链同事,在自动化对账脚本里需要权威订单行明细作为比对输入