海外运营平台账号余额查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-finance-account-cash。
技能介绍
要解决什么问题
在海外运营平台里做财务核对、对账或下单前校验时,业务侧往往只需要一个事实:指定会员账号当前有多少可用现金余额。若让 agent 直接拼 HTTP 请求,容易在环境地址、登录态 Header、Path 参数命名上各写各的,和平台网关契约不一致。
本技能是 最小颗粒度 的原子接口 skill,只负责 account_cash 这一动作:向正式环境发起一次 GET,用 memberId 查余额,并把接口原始响应交给上层编排。
技能如何工作
- 固定基址:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com),不接受用户输入覆盖。 - 参数结构:tool arguments 最外层仅包含嵌套对象
params;Path 写params.path(含memberId),登录态写params.accessToken,生成Authorization: Bearer(值已含Bearer时不重复拼接)。 - 请求形态:
GET /api/member/member-cash/accountCash/{memberId},无 Body;查询类接口仍受当前登录态、租户与用户权限约束。 - 返回原则:以接口响应为唯一事实来源,不补造库存、价格、订单号或优惠金额;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递。
适用边界
- 仅覆盖「查账号余额」单步;多接口业务链路需由上层 agent 按聚合 skill(如
platform-member-finance)或计划文档组合多个原子 skill。 - 若用户需求包含改账、冻结、流水明细等,本 skill 不负责,应选用同系列其它 action skill。
使用场景
- 海外运营 agent 在帮用户下单或充值前,需用 memberId 拉取该会员账号当前现金余额再决定是否继续
- 财务对账脚本只缺余额这一环时,由编排层单独调用本 skill,避免手写 kutetailor 正式环境 URL 与 Bearer
- 客服工单里用户质疑「账户里还有多少钱」,坐席 agent 按工单中的 memberId 查余额并把接口原文转述
- 上层按 platform-member-finance 聚合文档编排链路时,本步仅负责 account_cash,后续改账或流水由其它原子 skill 承接
适合人员
- 负责酷特海外运营平台会员账务、需把余额查询嵌入自动化 agent 的财务或运营同学
- 编写 platform-member-finance 等多 skill 编排逻辑,要把 account_cash 做成标准 HTTP 步骤的后端或集成工程师
- 处理海外会员资金类客诉,需要在对话里按 memberId 实时核对账号现金余额的客服或运营主管
- 做海外站点运营决策前,要对接正式环境 member-cash 接口、且不允许 agent 随意改 base_url 的平台治理人员