Agent Skills
返回列表
酷特海外运营平台子账号余额校验

酷特海外运营平台子账号余额校验

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-finance-validate-sub-balance。

技能介绍

要解决什么问题

在海外运营平台里,主账号往往挂着多个子账号,下单、扣款或结算前需要确认子账号现金账户是否满足业务规则。人工在后台逐个点查既慢,也容易和自动化流程脱节。本技能把「校验子账号余额」这一动作收敛成单一原子接口调用,方便上层 Agent 在财务、会员或订单编排里插入一步校验,而不必手写 URL、Method 和鉴权头。

技能如何工作

技能只负责 action:validate_sub_balance。执行器使用 frontmatter 中的正式环境地址 POST https://www.kutetailor.com/api/member/member-cash/validateSubAccountBalance,不接受用户输入覆盖 base_url。

调用约定与其它酷特平台原子 skill 一致:tool arguments 最外层仅包含嵌套对象 params。

  • 鉴权:登录态通过 params.accessToken 生成 Authorization: Bearer;若已带 Bearer 前缀则不再重复拼接。
  • 参数分区:Path 写入 params.path,Query 写入 params.query,JSON Body 写入 params.body(本接口为 OperateMemberCashRequest,application/json),额外 Header 写入 params.headers。
  • 返回:以接口原始响应为准,向上层传递关键字段;若出现认证、权限、参数或业务错误,应保留原始错误码与错误信息,便于后续 skill 或人工处理。

该接口属于查询/计算类,仍受当前登录态、租户与用户权限约束。

适用边界与注意点

这是最小颗粒度接口 skill,只完成本步校验,不串联充值、冻结、扣款等其它会员现金动作。完整链路需由上层 Agent 参照聚合 skill platform-member-finance 或计划文档组合多个原子 skill。

不要在返回结果中补造库存、价格、订单号、优惠金额或物流状态;若用户描述的是多步骤需求,本 skill 仅执行校验并交接结果,其余步骤交给其它 skill。

使用场景

  • 海外运营平台下单或扣款前,由 Agent 调用接口确认指定子账号现金余额是否满足规则
  • 在编排 platform-member-finance 链路时,插入单步校验,避免手写正式环境 URL 与 Bearer 鉴权
  • 用户口头要求「查子账号能不能付」时,仅执行 validate_sub_balance 并把 RS 关键字段交给后续 skill
  • 结算或对账脚本触发前,先对 OperateMemberCashRequest 对应子账号做一次平台侧余额校验

适合人员

  • 对接酷特 kutetailor 正式环境的集成工程师,需要在 Agent 里按 params 规范调用会员现金接口
  • 负责海外运营主账号与子账号资金规则的后台运营,希望通过对话触发平台侧余额校验而非手工点后台
  • 维护 platform-member-finance 聚合 skill 的编排者,要把 validate_sub_balance 作为链路中的固定原子步骤
  • 在财务自动化里串联多接口的上层 Agent 维护者,需要可回传原始错误码的单一校验动作