Agent Skills
返回列表
海外订单特体查询

海外订单特体查询

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-components-order-special 技能。

技能介绍

要解决什么问题

在 kutesmart 海外运营平台中,订单由标准品和特体(特殊定制件)共同构成。排查订单异常、核对履约范围或回答"这张订单里特体占了多少"这类问题时,通常需要精确获取订单特体的组成明细。平台自身提供了 selectOrdenSpecial 接口,但直接对接存在几个工程细节:登录态如何透传、参数如何结构化传递、错误如何向上透出——这些都需要统一处理。

技能如何工作

这个 skill 是订单组成明细聚合链路中的最小原子单元,只负责一个接口动作:order_special。

调用约定:

  • 入参结构:tool arguments 统一使用嵌套 params 对象。最外层只放 params,不使用 params.xxx 这类点号顶层 key
  • 查询参数:通过 params.query 传入 orderId,URL 中的 {变量} 从 params.path 替换
  • 认证方式:登录态接口使用 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer,不会重复拼接
  • 请求方式:GET /order/orden-special/selectOrdenSpecial,返回结果类型为 RS

执行器行为:

  • 固定调用正式环境地址,不接受用户输入覆盖 base_url
  • 按接口表选择 HTTP method 和 URL
  • GET/DELETE 查询参数放在 URL query;POST/PUT 请求体按参数列要求提交

适用边界与注意点

  • 不做业务补全:返回结果必须以接口响应为事实来源,不会补造库存、价格、订单号、优惠金额或物流状态
  • 错误透传:如果接口返回认证、权限、参数或业务错误,原始错误码和错误信息会原样传给上层 agent
  • 权限约束:属于查询/计算类接口,仍需遵守当前登录态、租户和用户权限
  • 编排职责在上层:用户需求若涉及多个接口步骤,本 skill 只完成当前接口调用,并把关键返回字段交给后续 skill,由上层 agent 按聚合 skill 或计划文档编排

使用场景

  • 客服收到买家咨询订单里定制件信息时,需按 orderId 查询订单特体组成明细并回复
  • 运营核对某订单的标准品与特体构成,确认特体明细后再进入履约审核流程
  • 开发者在排查订单详情页数据异常时,通过接口获取特体原始返回用于定位问题
  • 上层 agent 编排订单处理链路,调用该接口取得特体字段后继续后续接口步骤

适合人员

  • 电商平台运营人员,日常需要在后台按订单号查询特体明细并记录到履约表
  • 订单系统开发工程师,负责对接海外运营平台的特体查询接口并处理错误返回
  • 智能客服系统开发者,需要把订单特体查询能力集成到机器人回答链路中
  • 数据核对专员,每月需抽查订单特体数据与实际履约内容是否一致