Agent Skills
返回列表
海外运营平台订单预扣款检查

海外运营平台订单预扣款检查

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-cancel-confirm-check-withholding。

技能介绍

要解决的问题

在海外运营平台的撤单确认链路里,运营人员和上层 Agent 经常需要先判断一笔订单是否已经预扣款。如果不知道是否预扣,就贸然撤单,可能造成资金状态混乱:该退的预扣没退、不该动的订单被误操作,或者在客服、财务对账时找不到中间态记录。

靠人工在后台页面点开逐单查看,订单量一大就很慢;靠 Agent 直接猜或从其他接口反推,又容易和真实资金状态不一致。这个技能就是为了把「查订单预扣状态」这一步单独做成一个稳定、可复用的原子动作。

这个技能做什么

它只负责一个平台接口动作:check_withholding。调用正式环境固定地址:

GET https://www.kutetailor.com/api/order/order/orden/checkIsWithholding

核心能力很直接:传入 orderIds,接口返回 RS 结果,用来判断这些订单是否处于预扣款状态。

关键执行步骤:

  • 参数组织:tool arguments 统一使用嵌套 params 对象,最外层只放 params,不要使用 params.xxx 这类点号顶层 key。
  • 地址约束:正式环境地址固定在 frontmatter 的 base_url,执行器必须使用该地址,调用时不要从用户输入覆盖 base_url。
  • 登录态处理:登录态接口使用 params.accessToken 生成 Authorization: Bearer;如果传入值已含 Bearer,不要重复拼接。
  • 参数落位:Path 参数写入 params.path,Query 参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。
  • 请求格式:POST/PUT 默认发送 JSON body;如果上层接口网关另有约定,以网关契约为准。
  • 方法与 URL:按接口表选择 HTTP method 和 URL;URL 中 {变量} 从 params.path 替换。GET/DELETE 查询参数放在 URL query;POST/PUT 请求体按参数列要求提交。

适用边界与注意点

这是一个最小颗粒度接口 skill,不是完整业务流程。它只完成本接口调用,并把关键返回字段交给后续 skill。

当用户需求需要多个接口步骤时,例如完整撤单确认流程,应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。

返回结果必须以接口响应为事实来源,不要补造库存、价格、订单号、优惠金额或物流状态。

如果接口返回认证、权限、参数或业务错误,把原始错误码和错误信息传给上层 Agent,不要自行改写成其他状态。

这是查询或计算类接口,仍需遵守当前登录态、租户和用户权限。

使用场景

  • 运营在处理撤单前,需要确认订单是否已预扣款。
  • 客服核对订单资金状态时,需判断是否处于预扣款。
  • Agent 编排撤单流程,先调用该接口获取关键返回字段。
  • 财务对账时,需要确认相关订单的预扣款状态。

适合人员

  • 海外运营平台的运营工程师,需要在撤单链路中确认订单资金状态。
  • 负责撤单流程的后端开发者,需要编排原子接口调用并处理返回结果。
  • 搭建业务 Agent 的工程师,需要把该检查动作纳入订单处理计划。
  • 处理订单问题的客服技术支持,需要核对预扣款状态以定位问题。