Agent Skills
返回列表
海外返修平台·查询公司订单

海外返修平台·查询公司订单

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台的返修订单链路里,客服、运营或自动化 Agent 经常需要按单号核对「公司订单」侧的数据——例如确认 orden 是否存在于公司维度、把接口原始字段交给下游做状态判断或补录。若每个 Agent 各自拼 URL、混用测试地址或随意改 Header,很容易出现鉴权失败、参数格式不一致,以及虚构库存、价格或物流状态这类幻觉问题。

本 skill 只做一件事:在正式环境调用 company_order 对应的 GET 接口,用 Query 参数 ordenNo 查询公司订单,并把响应原样交给上层编排。

技能如何工作

  • 固定基址:执行器使用 frontmatter 中的正式环境地址 https://www.kutetailor.com/api/order/order/orden/getCompanyOrden,不接受用户输入覆盖 base_url。
  • 参数结构:tool arguments 最外层仅包含嵌套对象 params;Path 进 params.path,Query 进 params.query(本接口为 ordenNo),Body 进 params.body,额外 Header 进 params.headers。
  • 登录态:通过 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer 前缀则不再重复拼接。
  • 归属关系:属于聚合 skill platform-repairs-order 下的原子 action;完整返修流程需由上层 Agent 按聚合文档串联多个接口 skill。

边界与注意点

  • 本 skill 仅完成单次 company_order 调用;多步骤需求(查单后再改状态、关联物流等)需组合其他原子 skill。
  • 返回必须以接口响应为事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息传给上层 Agent,而不是本地猜测补全。
  • 仍需遵守当前登录态、租户与用户权限;查询类接口同样受平台侧权限约束。

使用场景

  • 海外返修工单处理中,客服需按客户提供的 ordenNo 调用平台接口核对公司订单是否存在及关键字段
  • 自动化 Agent 编排 platform-repairs-order 链路时,先执行本 skill 拉取公司订单,再把 RS 交给后续改状态或关联单据 skill
  • 运营复核返修单与公司侧 orden 不一致时,用正式环境 GET 查询结果作为对账依据,避免人工臆测订单状态
  • 集成测试或联调海外运营网关时,验证 Bearer 登录态与 query 参数 ordenNo 能否正确返回公司订单响应

适合人员

  • 负责酷特海外返修客诉的客服,需要在对话或工单里按单号即时查公司订单再答复客户
  • 搭建返修订单聚合 Agent 的集成工程师,要把 company_order 作为链路第一步并统一 params 与 base_url 约束
  • 海外运营同学每日处理返修异常单,需用接口原始错误码区分权限、参数与业务失败以便升级处理
  • 对接 kutetailor.com 订单 API 的后端开发,在 skill 执行器里落实固定正式地址与 Authorization 拼接规则