海外运营平台订单特体字符串查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指引,将 @user_ac9585d3/platform-order-components-order-special-str 安装到 AI 助手。
技能介绍
要解决的问题
在海外运营平台的订单组成明细里,订单特体字符串分散在 orden-special/selectSpecialStr 这类接口中。人工查询需要先确认正式环境地址、登录态 token、ordenId 参数和返回结构,再把结果插入到更大的业务链路里。重复对接既容易写错 URL,也容易把 Authorization、租户和用户权限检查漏掉。
这个 skill 如何工作
kutesmart-海外运营平台订单组成明细-查询订单特体字符串 是一个最小颗粒度的原子 skill,只封装一个接口动作:order_special_str。它的正式环境地址固定为:
GET https://www.kutetailor.com/api/order/order/orden-special/selectSpecialStr
调用时遵循以下关键步骤:
- 统一参数结构:tool arguments 只使用嵌套
params对象,不接受params.xxx这类点号顶层 key。 - 固定环境地址:
base_url来自 frontmatter,执行器不接受用户输入覆盖。 - 鉴权处理:登录态接口使用
params.accessToken生成Authorization: Bearer;如果传入值已包含Bearer,不会重复拼接。 - 参数传递:
ordenId作为 Query 参数写入params.query;Path 参数写入params.path,JSON Body 写入params.body,额外 Header 写入params.headers。 - 输出事实结果:返回以接口响应为唯一来源,不补造库存、价格、订单号、优惠金额或物流状态。
适用边界与注意点
这个 skill 只负责单次 order_special_str 查询,不负责完整业务编排。如果业务需要多个接口步骤,由上层 agent 聚合多个原子 skill 或按计划文档执行。它仍会遵守当前登录态、租户和用户权限;如果接口返回认证、权限、参数或业务错误,原始错误码和错误信息会原样透传给上层 agent。
使用场景
- 客服或运营排查海外订单异常时,需要按 ordenId 查询该订单的特体字符串,确认订单组成明细。
- 上层 agent 编排订单组成聚合流程,需要在某一步骤按 ordenId 获取订单特体字符串并交给后续环节。
- 开发者编写自动化脚本时,需要固定正式环境地址调用 selectSpecialStr,避免手动拼接 URL 出错。
- 业务人员核对客户订单的特体信息时,需要通过接口拿到原始返回字段,而不是翻查多个后台页面。
适合人员
- 海外运营平台的运营人员,需要按订单号查询订单特体字符串以处理客户问题。
- 负责订单系统对接的后端开发者,需要封装或调用单个订单查询接口并固定正式环境地址。
- 构建多接口业务流程的 agent 开发者,需要把该原子 skill 作为聚合流程中的一环来编排。
- 处理订单数据一致性问题的数据分析师,需要依赖接口原始返回字段而不是人工转述的特体信息。