海外运营平台订单客户查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-components-save-style-customer
技能介绍
这个接口解决什么问题
在处理海外运营平台的订单时,一个常见痛点是:订单主记录能看到,但“完整下单客户对象”拿不全。客户资料、下单人信息、关联的样式(style)与客户数据往往分散在多个接口后面,Agent 要么重复请求,要么在上下文缺失时凭记忆补造字段——库存、价格、订单号一旦被脑补,下游链路就会静默出错。
本技能把这件事收敛成一个原子动作:给定 orderId,用一次 GET 请求拿到该订单对应的完整下单客户对象,返回结果以接口响应 RS 为唯一事实来源。
技能如何工作
- 固定地址:正式环境地址写死在 frontmatter 的
base_url,固定为GET https://www.kutetailor.com/api/order/order/orden-customer/getOrdenCust,执行时不接受用户输入覆盖。 - 参数结构:所有 tool arguments 统一嵌套在
params对象下,本接口只需传params.query.orderId,不使用params.xxx这类点号顶层 key。 - 鉴权:登录态接口通过
params.accessToken生成Authorization: Bearer;若传入值本身已含Bearer前缀,则不重复拼接。 - 返回:接口返回
RS,作为查询结果的事实来源,不做任何加工或推测性补全。
它是 platform-order-components 聚合下的最小颗粒度接口,action 名为 save_style_customer。需要拼出完整业务链路时,由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill,本技能只负责自己这一步,并把关键返回字段交给后续环节。
适用边界与注意点
- 这是查询类接口,不会修改数据,但仍需遵守当前登录态、租户和用户权限约束。
orderId是必填 Query 参数,缺失时应按错误处理,而不是猜测一个订单号。- 禁止从响应之外补造库存、价格、订单号、优惠金额或物流状态;接口没返回的字段就是不存在。
- 遇到认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 Agent,不要吞掉或美化。
- 它是原子 skill,单独使用只能完成这一步查询;跨接口编排属于上层 Agent 的职责。
使用场景
- 查询订单时需要同时获取该订单关联的完整下单客户对象,用于后续客服跟进或订单核实
- 用户只提供订单号,需要一步拿到该订单对应的客户信息,而不逐个调用多个客户相关接口
- 核对订单信息时,需要以接口返回的下单客户数据为准,避免手工拼凑客户字段造成信息错误
- 上层 Agent 编排订单处理链路时,需要先拉取该订单的完整客户对象,再交由后续步骤处理
适合人员
- 运营人员:需要根据订单号快速查询客户信息,用于跟进订单状态或处理售后问题
- 后端开发者:负责集成订单查询接口,需要准确理解 GET 请求的参数格式和鉴权方式
- Agent 开发者:在编排多步骤业务流程时,需要一个可靠的原子接口来获取订单客户数据
- 客服人员:处理客户咨询时需要即时查看订单关联的下单客户详情,以便提供针对性服务