Agent Skills
返回列表
酷特海外运营·按用户名查账号

酷特海外运营·按用户名查账号

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台里,客服、运营或内部 agent 经常需要按用户名定位账号,再去做权限核对、订单关联或后续编排。若每次都在对话里手写 GET 地址和参数,容易混用环境、漏传登录态,或把多个接口步骤塞进一个「大工具」里难以维护。

本技能是最小颗粒度的原子接口 skill,只负责 member_by_username 这一动:根据 username 查询单个会员账号,并把接口真实返回交给上层继续编排。

技能如何工作

  • 固定正式环境:执行器使用 frontmatter 中的 base_url(https://www.kutetailor.com/api/member),调用 GET /member/getMemberOne,不接受用户输入覆盖 base_url。
  • 统一参数形状:tool arguments 最外层只放嵌套 params;Query 写入 params.query(本接口为 username);需登录态时用 params.accessToken 生成 Authorization: Bearer(值已含 Bearer 则不重复拼接)。
  • 返回以接口为准:响应字段以平台 RS 为事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息传给上层 agent,不要自行补造账号、订单或库存类数据。

适用边界与注意点

  • 用户若需要「查账号 + 改资料 + 下单」等多步链路,本 skill 只完成查账号这一步;完整业务应由上层 agent 按聚合 skill(如 platform-member-account)或计划文档组合多个原子 skill。
  • 仍是查询类接口,须遵守当前登录态、租户与用户权限;无权限时以接口错误为准,不要猜测结果。

使用场景

  • 客服收到海外用户报的用户名,需先调用平台接口确认该用户名对应哪条会员账号再处理工单
  • 编排 agent 在下单或改资料前,用 username 查询 getMemberOne 拿到会员主键与状态字段
  • 核对运营后台名单与平台账号是否一致时,按名单中的用户名逐条查询会员记录
  • 上层聚合 skill platform-member-account 编排链路中,单独执行 member_by_username 这一步并传递 RS 结果

适合人员

  • 处理酷特海外运营平台工单的客服,需要按用户提供的 username 核实会员是否存在及基础信息
  • 编写多步业务 agent 的集成工程师,要把 member_by_username 作为原子节点接入 platform-member-account 编排
  • 海外运营同学在做账号盘点或风控复核时,需批量或单次按用户名拉取单个会员接口结果
  • 对接 kutetailor.com 正式环境 member API 的后端开发,需统一 params.query.username 与 Bearer 登录态约定