酷特海外平台返修订单查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-repairs-order-repair-order-one。
技能介绍
要解决什么问题
海外运营里,返修订单往往分散在平台侧接口中。客服、履约或内部 Agent 若要在对话或自动化流程里按单号核对返修单,需要稳定调用酷特正式环境的一条只读查询,而不是在 prompt 里猜测订单状态或字段。
本技能对应平台动作 repair_order_one:用 GET /order/orden/getRepairOrdenOne,通过 Query 参数 ordenNo 拉取单笔返修订单(返回类型 RS)。它是最小颗粒度接口 skill;完整链路(例如先列表再详情、或与其它订单动作串联)应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。
技能如何工作
- 调用地址固定为 frontmatter 中的正式环境 base_url(
https://www.kutetailor.com/api/order/order/orden/getRepairOrdenOne),执行器不接受用户输入覆盖。 - 工具参数统一放在嵌套对象
params内:Path →params.path,Query(含ordenNo)→params.query;登录态用params.accessToken生成Authorization: Bearer …(值已含Bearer时不重复拼接)。 - 返回以接口响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent 处理。
适用边界与注意点
- 仅完成「查询单笔返修订单」这一步;多接口步骤不在本 skill 内自动串联。
- 虽为查询类接口,仍受当前登录态、租户与用户权限约束;不要根据返回臆造库存、价格、物流等字段。
使用场景
- 客服接到海外客户投诉后,需用返修单号在酷特平台核对单笔返修订单详情再回复
- 履约 Agent 在自动化流程中拿到 `ordenNo`,调用查询接口确认返修单是否存在及当前接口返回字段
- 编写返修订单聚合 skill 时,先单独验证 `repair_order_one` 的 Query 参数与 RS 响应结构
- 内部运维排查权限或租户问题时,对指定单号发起只读查询并原样记录错误码与错误信息
适合人员
- 对接酷特海外运营 API、需在 Agent 工具链里挂载单笔返修查询的原子能力的集成工程师
- 处理海外返修客诉、必须按单号查平台真实数据而不能凭聊天记录臆断状态的客服主管
- 编排 `platform-repairs-order` 等多步返修流程、负责拆分与组合原子 skill 的后端或 Agent 开发者
- 负责返修业务数据稽核、需用正式环境接口抽检指定 `ordenNo` 订单的企业运营或质控人员