Agent Skills
返回列表
酷特海外运营 · 成品订单详情

酷特海外运营 · 成品订单详情

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,客服、履约或运营 Agent 经常需要按订单号拉取成品订单的完整详情——例如核对 SKU、生产/发货节点、金额字段等。若每个 Agent 各自拼 URL、Bearer 头和 Query 参数,容易混用测试地址、重复加 Bearer 前缀,或在接口报错时自行「补全」订单状态。

本技能是 platform-order-query 聚合链路里的原子接口,只负责 finish_order_detail 这一动作:向正式环境发起一次 GET 查询,并把响应原样交给上层编排。

技能如何工作

  • 固定端点:使用 frontmatter 中的正式环境基址,调用 GET /order/order/orden/selectFinishOrdenDetails(完整地址为 https://www.kutetailor.com/api/order/order/orden/selectFinishOrdenDetails),不接受用户输入覆盖 base_url。
  • 参数约定:tool 参数统一放在嵌套对象 params 中;本接口在 params.query 传入 orderId。
  • 鉴权:登录态通过 params.accessToken 生成 Authorization: Bearer …;若传入值已含 Bearer,不再重复拼接。
  • 返回原则:以接口响应为唯一事实来源,不编造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,将原始错误码与信息回传上层 Agent。

适用边界

  • 仅覆盖单步查询;若业务需要列表、状态变更等多接口流程,需由上层 Agent 按聚合 skill 或计划文档组合多个原子 skill。
  • 仍为查询类接口,需遵守当前租户、用户与登录态权限;网关若对 POST/PUT 有额外约定,以网关契约为准(本动作为 GET)。

使用场景

  • 海外客服收到用户提供的 orderId,需要在酷特正式环境拉取该成品订单详情后再答复或建单
  • 履约 Agent 在核对发货/生产节点前,按订单号调用 selectFinishOrdenDetails 获取平台侧详情字段
  • 编排 platform-order-query 链路时,上层 Agent 将本步作为原子接口,只负责详情查询并传递 RS 给后续 skill
  • 运营排查订单争议时,用固定正式环境 GET 查询成品详情,避免手工拼 URL 或误用非生产地址

适合人员

  • 处理酷特海外订单工单的客服,需按 orderId 从平台 API 取成品详情再核对用户陈述
  • 负责成品履约跟进的运营,要在多步流程里单独拉一次订单详情作为事实依据
  • 集成 platform-order-query 原子 skill 的后端/Agent 工程师,需统一 params 与 Bearer 鉴权约定
  • 搭建海外运营自动化问答的 Agent 产品同学,要把 finish_order_detail 编入订单查询计划