海外返修平台·查询公司订单
将以下提示词粘贴到你的 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 拼接规则