酷特海外平台主账号余额查询
将以下提示词粘贴到你的 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 登录态的后端集成开发