Agent Skills
返回列表
酷特海外平台主账号余额查询

酷特海外平台主账号余额查询

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-finance-main-account-cash。

技能介绍

要解决什么问题

在海外运营平台上做账号财务核对时,运营或财务侧往往只需要一个事实:主账号当前有多少可用余额。若让 agent 直接拼 HTTP 请求,容易踩坑:正式环境 base_url 被用户输入改掉、登录态 Authorization 重复加 Bearer、Query 与 Path 混放,最后返回字段被「脑补」成库存或优惠金额。

本技能是 最小颗粒度 的接口 skill,只负责 main_account_cash 这一动作:向固定正式环境发起查询,并把接口原始响应交给上层编排。

技能如何工作

  • 固定端点:使用 frontmatter 中的正式环境地址 GET /member-cash/mainAccountCash(完整基址为 https://www.kutetailor.com/api/member/member-cash/mainAccountCash),不接受用户覆盖 base_url。
  • 参数约定:tool 参数统一放在嵌套对象 params 下;本接口在 params.query 中传 couponMemberId。
  • 登录态:通过 params.accessToken 生成 Authorization: Bearer <token>;若传入值已含 Bearer 前缀则不再重复拼接。
  • 返回原则:以接口响应为唯一事实来源,不补造余额、订单号或优惠金额;认证、权限、参数或业务错误时,将原始错误码与错误信息回传上层 agent。

适用边界与注意点

  • 用户需求若涉及多步(例如先查会员再对账),本 skill 只完成本接口;完整链路需由上层 agent 按聚合 skill platform-member-finance 或计划文档组合多个原子 skill。
  • 仍为登录态接口:需满足当前租户与用户权限,否则接口会直接报错。
  • 上层编排时请把本接口返回中的关键字段显式传给后续 skill,避免在对话层自行推断财务数据。

使用场景

  • 海外店铺运营在核对会员主账号前,需用 couponMemberId 拉取主账号当前现金余额
  • 财务月结时 agent 编排链路中,单独调用本接口获取主账号余额作为对账输入
  • 客服处理「账户里还有多少钱」类咨询时,只查主账号余额、不串联下单或优惠接口
  • 上层聚合 skill 组合 platform-member-finance 时,用本原子 skill 完成 main_account_cash 一步

适合人员

  • 负责酷特海外运营平台会员资金核对、需按会员 ID 查主账号余额的财务专员
  • 搭建 platform-member-finance 聚合链路的 agent 工程师,需要可复用的 main_account_cash 原子接口
  • 处理海外会员账户余额咨询、必须以正式环境接口响应为准的客服或运营主管
  • 对接 kutetailor 会员现金 API、要在编排里固定 base_url 与 Bearer 登录态的后端集成开发